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PREFACE 



This maiuial is an introduction to tiic use of the Alto coniputei-s at Stanford. It contains a number 
of documents which should give you some orientation and acquaint you with the basic fiicilities 
available. 

The Stanford User's Manual contains information specific to Alto use at CSD, and a number of 
caveats worth noting. 

A Field Guide to Altoland is a Xerox document which provides many helpfiil pointers to further 
information, as well a good deal of background material and general info about Altos. However, 
since it was intended for Xerox employees, many details arc irrelevant to usage at Stanford. Read 
the Stanford User's Manual first. 

The Alto Non-programmer's Guide introduces you to the Alto executive program and a number of 
operating system functions necessary to maneuvering yourself around in Altoland. Skip section 2; 
it's not applicable here. 

The linm) Manual is a fairly complete guide to Bravo, the main Alto editor. 

Alto PUP FTP explains the file transfer program for communicating with with the /nterim File 
.Verver and. otlier Alto disks. 

Laurel Manual documents Laurel, the Alto mail handling facility. Don't overlook the on-line 
I,aurcl tutorial, which you can access from the executive by typing: 

Fl'P ll-S Rct<Lauicl>LaurclNcwUscr.cmCR 
©LaurelNewUscrCR 



h'inally, the Alto Subsystems Catalog contains pointers to documentation of the major Alto 
subsystems. Note, however, that some of the subsystems mentioned are not available at Stanford. 



Happy Hunting! 
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Welcome to ALTO land! 



Stanford ALTO user's manual 

The Stanford University Computer Science Department has 16 ALTO computers 
availal^lc for use, plus an /nterim File .Server (IFS, nicknamed Lassen), and a high 
quality printer (DOVER, nicknamed Tahoe). This document explains how to get 
started, where to go for information, and special features of the Stanford Network. 
There is no current local ALTO expert. Copies of the Alto User's Handbook and 
Mesa Language Manual are available from Connie Stanley in the publications office, 
room 206 for a $5 deposit. 

Before using an Alto it is recommended that new users read those parts of the Alio 
User's Handbook which concern them. Note, however, that the User's Handbook 
assumes you are working for Xerox, and the situation at Stanford is slightly different. 
Thus, ignore section 2 of the Non- programmer's Guide, and all references to Maxc. 
Field Guide to Altoland also contains much useful information, but it also is oriented 
to Xerox employees, so many details do not apply here. 

At Xerox, each user has his/her own Alto and several disk packs. At Stanford, the 
Altos arc publicly available, and each has two general-purpose disks. It is the user's 
responsibility to save and restore the files needed during a specific session. Any user is 
welcome to use any Alto which displays a Stanford Symbol (a little tree wandering 
randomly around the screen). If the yellow ready lights are not on for both disk 
drives, switch them to the run position and wait for the ready lights to come on. 
Boot the Alto by pressing the button on tlie back of the keyboard between the cables. 
When you are done type QuitCR to the executive, and turn the disks back to load 
when the Stanford symbol reappears. If another user will be using the Alto soon, 
don't bother turning the disks off. Just have the next user type in the LoginCR 
command. 

The directory <AltoDocs> contains documentation that users can print. For 
example, this document is stored under <AltoDocs>Wclcomc.Press. To print it, use 
Chat to log on to Lassen and type Print <AltoDocs>Welcome.PressCR , and then 
Host DoverCR . Please do not print manuals longer than 50 pages on tlie Dover 
without asking around for someone else's copy to borrow. 

The <Forms> directory contains several useful forms. The Stanford CSD letterhead is 
stored under <Porms>l'orm.Letter. <Forms>Form.PcrsonalLetter should be used for 
non-official letters. TitleBlock.Sil is used to title logic diagrams done in CSD. 
Schedule.Draw is a Draw format outUne for a class or office hours schedule. 



© Stanford University Department of Computer Science, 1980 



Stanford ALTO user's manual 



Accounts 

Our grant from Xerox states that the ALTOs should be used for teaching and research 
applications. Accounts are needed to bootstrap and to use the Stanford disk, and to 
obtain permanent storage on the IFS. If you want an Alto account, fill out "new 
accounts" form and return it to Susan Hill. 

After booting a disk, type your name, return and your password. The password is 
checked for validity as an IPS account and remembered by the operating system. 
When you are finished with a session, anotlier user can use the Alto by typing a 
LoginCR command. 



Mail 

The Laurel mail system is used to announce new changes and additions to the system. 
When you log in, you will be notified if you have any unread mail. New messages are 
queued on the I-assen directory <Mail>Box> and are fetched automatically by Laurel. 
The problem is that Laurel expects to keep a working mail file on the local disks. We 
have solved this problem by writing a command file that FfP's the working file to and 
from Lassen. To use it type " ©Mail " instead of " Laurel ". After retrieving your 
Active.Mail file, the command file invokes Laurel with an automatic check for new 
mail. After you quit from Laurel your Active.Mail file Is returned to the TFS. Note 
that if the next person to use your Alto just runs Laurel instead of using the command 
file, he will get your mail file. 

@Mail has been changed to delete Activcmail files and fetch distribution lists from the 
IFS. The distribution list bboard contains every known user, so an effect similar to 
the SCORE bboard can be achieved by sending to bboardt. 

Other System News 

You can now print press files from Lassen dirccdy witliout first rctricvcing tliem with 
FfP. Use die Print command from FTP Telnet or Chat. Due to an IFS bug you must 
specify the printing host Tahoc (or Dover) each time the Print command is used. The 
FTP Reference Manual to be found in Alto User's Handbook may be outdated. 
Check <AltoDocs>Ftp.Tty on-line for more current info. 

Several command (.cm, .do) files have been added that make certain common 
commands easier to do. ©Clean will clean-up the local disk by deleting non- 
pcrmancnt files. "Do Get <nicname>" will do an FFP retrieve of <filcname> from 
l-assen. "Do Put <filenamc>" will do an FI'P store to the IFS. A few new fonts have 
been installed on the Dover. One of these is Stan200, default font #2 in Bravo. It 
contains the Stanford seal as character S, and the letters "c", "i" and "s" for a logo 
for the Center for Integrated Systems. 

Complaints, comments, suggestions, improvements, etc. should be sent to your 
local guru, if you can find one. This manual was written by Bill Nowicki, May 1980 
and revised by Kd Kalis, September 1980. 
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Network Names 

All the EthcrNct hosts (including Altos) have been, given names. The list is stored on 
<Systcm>Pup-Nctwork.txt. Names correspond to mountains, valleys, lakes, and 
wilderness areas witliin California. I'he name of your Alto should appear in one of the 
operating system's header lines. Locations are subject to occasional changes. 



Host Computer Names 



Yolo 


MJH 460 


Inyo 


MJH 460 


Yuba 


MJH 460 


Mono 


MJH 460 


Diego 


MJH 225 


Mojave 


MJH 408 


Yosemite 


MJH 408 


Marin 


MJH 450 


Monterey 


MJH 450 


Madera 


MJH 433 


Trinity 


MJH 433 


Toro 


MJH 416 


Napa 


MJH 416 


Almanor 


MJH 328 


Palomar 


MJH 020 


Lassen, 




Stanford-IFS, 




IF-S 


MJH 020 


Tahoc, 




Stanford-Dover, 




Dover 


MJH 221 


Shasta, 




VAX, 




VAXL 




VLSll 


MJH 433 


VAX2. 




VLSI2 


MJH 433 


VAX3, 




ISL-VAX 


Durand 


Sail, SU-AI 


MJH 020 


Score 


MJH 020 


IIR, 11/45 


MJH 029 



( ALTO/Terminal room) 



(HPP terminal room) 



(Office Suite) 

(SUMRX) 

(Music room, for debugging VAX interface) 

(Student jungle) 

(NA terminal room) 

(Machine room, for debugging SAIL interface) 



(File Server, in machine room) 



(Dover printer, in Xerox room) 



(Center for Integrated Systems computer room) 



(Information Systems L;iboratory) 

(KL-10 in machine room) 
(DIIC 2060 in machine room) 
(Robotics group PDP-ll/45) 
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Raison d'Etre 

Arc you a programmer? Are you sick of manuals that tell you how to use a software system 
without telling you why it behaves as it docs? Are you frustrated because you don't know the 
unstated assumptions behind the interesting discussions you hear around you? Have you ever 
wanted to browse through the source code or the documentation for a program, but couldn't figure 
out where to find it? If the answer to some of these questions is "yes", read on! These and other 
useful (and occasionally entertaining) tidbits shall be made known unto you. 

You will doubtless read many documents while you are at Xerox. A common convention observed in many manuals and 
memos is that fine points or items of complex technical content peripheral to the main discussion appear in small type, 
like this paragraph. You will soon discover that you cannot resist reading this fine print and that, despite its diminutive 
stature, it draws your eyes like a magnet. This document has such passages as well, just so that you can begin to enjoy 
ferreting out the diamonds in the mountain of coal. 

There is a great deal of usefiil information available on-line at Xerox in tlic form of documents and 
source program listings. Reading them is often very helpful, but finding them can be a nuisance. 
Throughout this document, references to on-line material are indicated by {n}, where n is a citation 
number in the bibliography at the end of this document. Standard citations to the open literature 
appear as [n]. 

Reading a document from front to back can be mighty boring. This document is organized so that 
(supposedly) you can browse through and read the parts that look interesting. This means that the 
usual bottom-up approach to documentation (define your terms before you use them) has been 
abandoned. Instead, all the relevant terms, acronyms, and the like have been collected in a glossary 
at the end. Some information is contained only in the glossary, so you may want to scan through it 
later, it is assumed that you have a basic knowledge of computer science, and a modicum of common sense. Don't 
expect to find terms like "computer" and "network" in the glossary. 
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Alto-Land 

Behind that inviting screen there lurks a wealth of fascinating history, folitlore, and (occasionally) 
documented wisdom. However, even the great storytellers of old occasionally forgot that their 
attentive audiences included travelers from other lands who were ignorant of the local customs and 
traditions. So it was with the Alto gurus. What follows is a transcription of tlie oral history of the 
Alto culture acquired by a relatively recent settler in these parts. It makes no claim to 
completeness, balance, or fairness. (A separate document exhibiting these qualities may be found 
on [20}.) 

A Rosa by Any Other Name ... 

Before exploring Alto-land, you should know something about the names of the creatures you will 
find there. The prevailing philosophy about naming systems in PARC, ASD, and SDD is perhaps 
somewhat different from the trend elsewhere. While we have our share of alphabet soup (e.g., 
PARC, FTP, MAXC, IFS), we are trying to avoid making it any worse. Names for hardware and 
software systems arc taken from the Sunset Western Garden Book [14]. individual Alios also have names 
which frequently, but not necessarily, come from the same source. These names arc chosen by individuals and 
registered with Art Axclrod. As this convention about names does not meet with universal approval, it 
seems inappropriate to offer a justification of the underlying philosophy without offering equal time 
to the opposition. You will doubtless provoke a far more interesting discussion if you advance your 
own views on naming to almost anyone wandering in the corridors. Accordingly, we abandon the 
topic here and move on to more concrete matters. 

The Alto hardware 

The first thing an immigrant notices about the Alto is that there are a lot of them. U seems that 
every office has one. In fact, there are, order of 1000 Altos in existence, though only some of these 
are at PARC. The genus comprises two species, imaginatively named Alto I and Alto II, and there 
are several sub-species as well. All members of the genus have at least a display, a keyboard, a 
mouse with 3 keys, and a processor/disk cabinet. You can normally spot an Alto II by its larger 
keyboard witll extra buttons on each side. You can even spot an Alto ll blindfolded - the "feel" of its 
keyboard is unmistakable. In fact, at a major demonstration attended by many important Xerox people, Alto II's were 
used bcrau.se of their flexibility, but Alto I keyboards were attached to them. Alot II's are getting cleverer, however; the 
newer models come with keyboards that "feel" more like Alto I's, but cost a lot less. 

The innards of the Alto are revealed in gory detail in a very complete manual {1}. Facts, figures, 
specifications, and programming information (at tlie machine level) are all there. What isn't there is 
a bit of the philosophy underlying the machine design and organization. In particular... 

1) There isn't much special-purpose hardware in the Alto. Most of the nifty stuff you can 
read about in the hardware manual is in fact implemented by microcode. This gives us 
considerable ncxibility in the way we design software interfaces for experimental devices 
and specialized instmction sets. In fact. Mesa and Smalltalk are implemented almost entirely with 
"special" microcode. 

2) The display is ratlier different from a number of other common displays. Instead of 
containing a character or vector generator, the display hardware inteiprets individual bits. 
One bit in memory shows up as one dot on the screen. Since the screen is 606 by 808 
points, a quick calculation shows that a full-screen display requires nearly half the standard 
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Alto memory. For a machine with only 64K of memory, that seems a big price to pay. 
The theory is that in exchange for the space we get enormous freedom to experiment with 
various strange ways of manipulating the screen. 

So much for philosophy - how does it work out in practice? Well, excessive flexibility breeds chaos, 
so a number of things have been standardized. All Altos contain a ROM that defines the "normal 
emulator" (i.e., the standard instruction set) and the standard i/o device interfaces (e.g., display, 
disk, etliernet, and so-called "junk i/o" - the keyboard and mouse). The instruction set is derived 
from the Data General Nova, though tlie i/o structure is rather different and several specialized 
instructions exist to support various display manipulations, if you have a spare hour or so, read about 
BITBLT in {1}. Then try to imagine writing the microcode to implement it Since the microcode for these 
Standard facilities is blown into a ROM, suggestions for improvements/extensions are treated with 
considerable skepticism, particularly since there are 500 or so Altos around. Microcode hackers will 
find tlhe additional IK control RAM available on all Altos a reasonably comfortable sandbox in 
which to play, if you arc both a microcode hacker and a concrete pourer, you can also use a second IK ROM on an 
Alto II. 

The display has enormous potential, and there are a number of programs around that exploit it in 
interesting ways. We also feel compelled to note that at least an equal number of programs still 
treat the display as a glass teletype. Home-made cookies require more effort, but they taste a lot 
better than the store-bought variety. Fortunately, more and more people are getting into home 
cooking. 

The mouse has two obvious properties - it rolls and it clicks. Inside the Alto hardware, the mouse 
position and the display cursor position are completely unrelated, but most software arranges for the 
cursor to "track" the mouse's movements. The three mouse buttons are named red, yellow, and 
blue, even though physically they are nearly always black. This choice was made because not all 
mice have their buttons arranged in the same way. On some (older) mice, the buttons are thin, 
horizantal bars; the top one is red, the bottom one is blue. On most mice, however, the buttons are 
wide, vertical bars, with red at the left and blue at the right. Some people insist on naming the buttons red. 
yellow, and green - perhaps as kids they had strange paintboxes, or were fixated on traffic lights. 

A somewhat unusual property of the Alto is that the keyboard and mouse buttons are unencoded; 
tliat is, tliere is a bit for each key that indicates whether the keys is up or down. Many programs 
distinguish between holding a mouse button down and clicking it down and up. Fewer programs 
play such tricks with the keyboard, although combinations of keys that would jam a conventional 
typewriter are quite meaningfiil to some programs, e.g., the NetExec. Fortunately, there is standard 
software that enables you to treat the keyboard in the usual way if you want to. 

With a personal computer, you are programmer, system hacker, and console operator all rolled into 
one. If you don't like the state your program has reached, you can always press the boot button 
and start over - an option you rarely have on larger, shared machines. Ffowever, the Alto differs 
from many small computers in that it lacks those time-honored, nitty-gritty debugging facilities - 
tlie console lights and switches. If things arc so screwed up inside that you can't get some sort of 
(software) debugger running, there isn't much you can do as console operator. This tends to down- 
play the operator role and emphasizes the system hacker role. ("Let's see, if i hit shift-Swat, that will write 
the core image on Swatee, and if I then bootload the debugger...") It also makes certain kinds Of bugs, e.g., 
those tliat smash crucial memory locations in low-core, very difficult to find. 
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Small Fish in a Big Pond - the Network 

Two's company, three's a network. You can do a lot with an Alto, but at best it's still a classy 
minicomputer. With hundreds of them out there we should be able in theory to do all sorts of 
wonderful things. In practice, we actually do some of them. You should read the paper by 
Metcalfe and Boggs describing the Ethernet [2] for a good introduction to the communication 
network that connects our Altos together. In essence, a collection of Altos within reasonable 
proximity is hooked together by an Etlicmet. Ethernets arc connected to each otlier by Gateways, 
which for most purposes allow us to ignore the topology of tlie resulting network. However, 
occasionally it's nice to know where things really are, and that's when a map {3} is helpful. For 
programs (which are notoriously poor map readers), Uio Gateways also provide an information service {15}. 

We all know how uncommunicative computers can be when left to dieir own devices, and Altos are 
no different. That's why we invent careful protocols for them to use in talking to each other. Most 
of the protocols now in use on the Ethernet are called PUP-bascd (Pare Universal Packets) {16}. 
Built on top of the Pup protocol are quite a number of others, some of which you can read about 
in {4,5,6,7}. You will probably hear some of the following protocol names being tossed about in 
conversation: 

0) EEFTP - a grand-daddy of file transfer protocols (Experimental Ether FI'P). No longer 
in active use. 

• 1) ¥Fl? - sL-inds variously for Early FTP, Ears FfP, Experimental FFP, Ether PTP. Easy 
FTP. A venerable protocol now mostly used to transfer files to printing serveis. The Alto 
program EmPress uses it for tliis purpose. 

2) FTP - refers to the File Transfer Protocol, as well as the Alto program that implements 
it and provides an interactive user interface. If you come from the Arpanet world, don't 
confuse this l=TP with the one out there - ours is Pup-based and incompatible. On MAXC, 
where both the Pup and Arpa FI'P protocols come in handy, the name FIT refers to the 
Arpa one and PupFTP (obviously) refers to the Ediernct one. 

3) BSP - the Byte Stream Protocol. Built on top of Pup, this protocol is used by 
convcrsants who want to view the network as a full-duplex stream of 8-bit bytes. BSP is 
used to implement FI'P and Chat. 

4) MTP - the Mail Transfer Protocol. Used by Laurel (the Alto-based message system) to 
ship messages to and from mailbox servers. 

There are quite a few other protocols in use as well. The wisdom here is: if you have some nifty 
multi-machine communication to do, look around - someone may well have done your protocol 
work for you. riicre also arc a number of communications wizards about who can keep you from 
falling into various traps. 

Question: Why have a network? Answer: Because it's nice to be able to pawn off some of the 
dog work on other machines, leaving your Alto free to do the interesting stuff That's why we have 
a number of machines generically called servers. Normally, server Altos have special purpose, 
expensive hardware attached to them (e.g., large-capacity disks, printers), and their sole purpose in 
life is to make that hardware available to more than one person/Alto. We tend to identify servers 
by function, so we talk about printing servers, file servers, name lookup servers, mailbox servers. 
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and so on. Many of die protocols for use of the Ethernet were developed precisely so that personal 
Altos could communicate effectively with server Altos. 

Printer servers and File servers get the biggest workout, 'fhere is considerable history and folklore 
surrounding printing and printing servers - you will find some of it in later sections of this 
document. One doesn't tend to hear much about file servers, except when they are down; nevertheless, 
they arc essential to our computational well-being. Because Alto disks arc rather small (another 
topic we'll come back to later), we rely heavily on file servers to store libraries of Alto packages, 

subsystems, and documentation, in Palo Alto, our primary file sci-vers arc Maxcl and two IT-'S servers. Ivy and 

Iris. A file server also acts as the natural common repository for the "truth version" of a system 
being constructed by a number of individuals. Once you begin to write programs (and mn out of local 
disk space), you will soon discover tlie importance of these facilities in our daily computing. 

Alto software 

The first high-level programming language used on the Alto was BCPL, and an overwhelming 
majority of Alto cycles is still consumed by BCPL programs. Other languages exist however: 
Smalltalk [18] (an integrated, interactive, object-oriented programming system). Mesa [19] (a 
strongly-typed, PASCAl,-like implementation language). Poplar (a simple interactive, text-oriented 
language), a version of LISP, and others. Mesa and. Smalltalk arc the most widely used. 

There is a reasonable amount of introductory documentation for systems you commonly need (e.g.. 
Bravo, l-l'P, the Alto Executive) in [13]. This is by far the most useful single reference for the Alto 
environment. Since the entire document can't be reprinted when any subsystem changes, however, 
you can expect the information there to be somewhat out of date at any one time, if you suspect you 
need the latest documeiUation for some program X, you might try [Maxc]<Altonocs>X.press (or X-npws.press). 

llie early development of the Alto programming environment was influenced considerably by existing software for the 
Nova. We still .see this influence in a few places, e.g., certain file-name extensions. However, the desire to communicate 
with otJier Altos and with IVIaxc has had a stronger effect on software written in recent years, and the importance of the 
Nova is now mostly historical. 

The Alio Operating System 

iiCPL programs typically run on top of the Alto Operating System, which is itself written in BCPL. 
Like most OSs, diis one provides a number of basic facilities, not all of which are needed by any 
one program. Because the small memory of the Alto is precious, a technique called "Junta" exists 
which permits BCPL programs to get rid of unneeded portions of the OS during their execution. 
"Counter-Junta" brings them back. You can read about the layers of the OS in {8}. 

Mesa programs do not use the Alto OS at all, mostly because Mesa and BCPL have rather different 
philosophies about the run-time world in which they exist. It is also a considerable nuisance for 
Mesa and BCPL programs to communicate, since their underlying instruction sets arc completely 
different. So, most of the important OS facilities (e.g., tlie file system) have been (re-)implcinented 
directly in Mesa. Mesa's memory management strategies replace the revolutionary tactics of "Junta" 
and "Counter-junta" widi the (relative) anarchy of segment swapping. 

There is a program called the Executive which runs on top of tlie OS and provides a command 
interpreter with a number of natural facilities, such as "tell me what files are on this disk", "run this 
program", "execute this command file", "go away". System maintainers will tell you that the Hxccutive is 
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"just another program - if you don'l like it, you can write one yourscir'. That's true - you could also write a Mesa 
compiler yourself, but ... . In all fairness, however, Uic l-.xccutive is one of a number of programs that have reached the 
state where maintenance consists of aggravating details. Consequently, requests for feature enhancement are not likely to 
fall upon receptive ears. Perhaps the most useful features of the Executive are file name completion 
(HSC) and *-cxpansion, particularly in conjuction with subsystem invocation. You should also read 
about control-X and control-U in the Executive section of {10}. 

No matter what program you are running, there are times when you want to say "get me out of this 
mess and back to somewhere more comfortable!" Unless things are really messed up, you have two 
choices, both of which require you to know where the Swat key is. (This invaluable key is 
iinlabclled, and is in different places on Alto I's and II's. On Alto 1 keyboards, it is at the extreme 
lower right, next to the shift key; on Alto II's, it is at the extreme upper right, separated somewhat 
from tlie main keyboard area.) By hitting shift-Swat, you can normally get back to the Hxecutive. 
To get back to where you were, u.se the Executive command "Resume". Control-shift-Swat will normally get 
you into Swat (the BCPL debugger). What you do there is your own business (see {10}). . Control- 
Swat will get you to the Mesa debugger if you are in a Mesa program, and there is a Mesa debugger on your disk, and 
it is installed, and your core image isn't too badly screwed up. If you are just trying to abort whatever program you 
are mnning, you probably don't want to be in the debugger anyway. And just to keep you on your toes, only the left- 
hand Shift key works here! If these last-ditch facilities don't seem to work, things are very confused, 
and you will have to boot your Alto, using the little white button that is not only unlabellcd, but 
hidden behind the keyboard. 

The Network Executive 

There arc several facilities available over the l^thernct that do not require a disk. You can boot any 
one of these programs into your Alto by pressing down a strange collection of keys simultaneously 
and hitting the boot button, but there is an easier way. If you hold down the BS and ' (single 
quote) keys and hit the boot button, you get the NetExec, a simple executive to which you can type 
tlie name of the program you want to boot into your inachine. Typing "?" will tell you what is 
available. The most frequently used facilities arc the Scavenger, Chat, Copy Disk, and FFP. You 
can also get a variety of diagnostic programs, the most popular being DMT. 

The A Ilo file system 

Most general-purpose computer systems have some sort of file system, and no two of them arc 
exactly alike. Programmers tend to assimilate the assumptions of their local file system so 
completely that they forget that other systems do things differently. As a result, they sometimes get 
burned when they start programming under a different system. Let's consider some of the itnplicit 
assumptions behind the Alto file system organization. 

Alto disks are self-contained. Iixccption: there exist Altos with two disk drives that am be conngurcd to spread 
the file system acro.ss both disks. I'orgct about this case for now. Each one has a single directory in which the 
visible names of the files arc stored. [■Inc point: multiple directories are permitted, but mo,sl software can't 
handle them. Names consist of a file name proper, optionally followed by a period and an extension. 
Actually, file names are terminated by a "." and may contain any number of embedded "."s. Dividing the name into 
two parts with a single "." is purely a convention, though a widcly-obsei-ved one. Certain conventional extensions 

exist, e.g., ".mesa" for Mesa source programs. All of this is probably familiar to you froin other 
systems. 

Wrinkle #1: The Alto file system supports version numbers that arc essentially the saine 
as those of TENEX [9], but almost no one uses them. If you are thinking about using 
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version numbers, don't. 1'hcrc arc some lurking bugs in the Alto OS related to version- 
numbered files. In addition, many Alto programs don't support version numbers (notably 
those written in Mesa, for low-level implementation reasons). Unfortunately, you don't 
find out which ones they arc until it is too late. 

Wrinkle #2: Because multiple versions are impractical, writing a "new version" of a file 
really means writing on top of the old one. Nearly everyone who isn't accustomed to this 
(particularly PDP-10 hackers) gets burned by it at least once, (However, there is an 
important exception: Bravo and Markup maintain explicit backup files even when 
version numbers are disabled.) 

Wrinkle #3: Alto files consist of pages. Each page carries with it the number of 
significant bytes it contains. Thus, in principle, a file need not be a sequence of full pages followed by 
a single partially full page. In fact, however, strange tilings will happen if you manage to construct a file in 
which any page (except possibly the last one) is not full. Fortunately, it is hard to do so. 

Wrinkle #4: In the directory, all file names have a teiTninating ".". Within the layers of 
software that access the directory, some define interfaces that expect the terminating 
period, others supply it automatically. Not all subsystems mask these internal differences 
effectively; thus, various programs have different ideas about what "ArbitraryFileName" 
and "ArbitraryFileName." mean. Ah, the wonders of information hiding and abstract specincations... 

Wrinkle #5: Alto files always have a page at the front called a leader page, which holds 
various interesting and useful data about the file (e.g., when it was last written). For 
obscure reasons, the Alto file system prefers tliat the lasi page of the file contain less than 
512 bytes of data. This means that a logically empty file actually takes two pages, one for 
the leader and one conUiining significant bytes of data. 

Wrinkle #6: The Alto disk architecture permits a representation for files that drastically 
reduces the possibility of a hardware or software error destroying the disk's contents. The 
basic idea is that you must tell tlic disk not only the address of the sector you want to 
read/write, but also what you think that sector holds. This is implemented by dividing 
every sector into 3 parts: a header, a label, and a data field. Kach field may be 
independently read, written, or compared with memory during a single pass over the 
sector. The Alto file system stuffs a unique identification of the disk block (consisting of 
a file serial number and the page number of the file) into the label field. Now, when the 
software goes to write a sector, it typically asks the hardware to compare the header and 
label fields against data in memory, and to abort the writing of the data field if the 
compare fails. This makes it pretty difficult, though not impossible, to write in the wrong 
place. The label field also contains links (disk addresses) to the predecessor and successor blocks of the 
file. Ii happens thai if the compare logic of tlic disk microcode sees a particular pattern in a memory word, 
it omits the comparison on that word and instead overwrites the pattern with the data from the 
corresponding disk word. 'I'lius, by cleverly arranging the memory "image" of a label field to be compared, 
the software can get the safely check on the block identification AND obtain the disk addresses of the 
neighboring blocks in the same operation. Cute, huh? More information about the disk system 
and how the software exploits it may be found in {1} and the "Disks and BFS" section of 
{8}. 

You should also know about the Scavenger, a program that rebuilds the file staicturc (but not tiie file 
content) of an Alto disk. Despite the checks and balances of the file system, occasionally things get 
smashed or lost. When they do, running the Scavenger is die best first attempt to recover diem. 
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The Scavenger is available from the NetExcc, so even if your disk is so messed up that you can't 
boot it, help is available. You can read more about the Scavenger and what it can do in {10} and 
[13]. 

Big Fish in a Small Pond - the A I to disk 

Lots of smart people have spent lots of man-years producing lots of nifty software for the Alto. 
Programs to manipulate directories, programs to format documents, programs to make pictures and 
illustrations, programs to transfer files, disks, and messages around, programs to help you write 
programs, programs to ... oops, you just ran out of disk space. 

We all know that you can't have your cake and eat it too. With a small disk, you can't even have 
it, most of the time. Most people are amazed to learn that an Alto disk will hold over 4800 pages - 
they rarely sec one with more than a few hundred available. You will quickly discover that many 
programmers spend a significant fraction of their day switching disk packs or running VIP. Some 
do both. There's no real cure for this disease, but by being aware of what is costly in space, you 
can make the pain less acute. Let's see where tlic space goes by "building a disk" from scratch, so 
to speak. 

Naturally, there arc a few things that you just can't live without. You must have an Operating 
System, an Executive, and a number of files that go along'with them. You also need the basic file 
system machinery (die directory and the disk descriptor so you can allocate disk space). You also should 
have Swatce and probably Swat, though the latter isn't really essential. There are also a number of 
small files that the OS and the F-Accutive expect to find around - don't try to get rid of them, they 
will just come right back. Even so, a disk with just the OS, Executive, Swatee, Swat, and friends 
still has about 3900 pages free. 

Next come the facilities you nearly always want - FTP and Bravo. FIT can always be obtained 
from the NctExec, but that takes a while and you use it frequently, so most people keep it around 
on the disk. It consumes about 180 pages. For wizards and hackers, there is a version of FIT hiding in.side 
SYS.BOOT, and one can put together a small kludge that transfers control to it. 'this way you can have TTP without 
giving up the full J80 pages it normally needs. Bravo is a good deal larger, weighing in at about 650 pages 
by tlic time you count all its related files and a font or two. Still, if you want to edit, you've pretty 
much got to have it. With FLP and Bravo, your disk is now down to around 3000 free pages. 

At this point,- things begin to diverge, depending on your plans for the disk. As an example, let's 
consider a Non-Programmer's Disk. This is a disk designed mostly for producing memos and 
documents and contains lots of files appropriate for these tasks. When you get it, it has about 1600 
free pages - a comfortable amount, but quite a drop from 3000. Where did those pages go? Well, 
first there arc the forms - files containing templates for things you commonly produce, like memos, 
letters, etc. The standard bunch only consumes about 40 pages - cheap. Then come the fonts ... 
and disk space starts to disappear. Screen fonts (so that Bravo can display things) occupy about 100 
pages, and you should probably retain the standard bunch (on a N on- Programmer's disk, at least). 
liVcn though liars is effectively dead, many Non-Programmer disks still have a collection of .UP fonts, nicse arc used 
only Lo format documents for Uars, and by deleting them you recover 450 pages. The real spacc hogS are 
subsystems you rarely use. Chat takes 130 pages, and unless you spend a great deal of time talking 
to Maxc (in which case you probably don't care about Alto disk spacc), you might as well get it 
from the Netluec when you need it. Markup and Pressf?dit occupy another 210 pages. Draw takes 
150 more. Unless you use these f^icilitics regularly, you are wasting 300 pages. DDS requires 275 
pages, and you rarely need its generality; you'll probably prefer to use Neptune or just get by widi 
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the standard Bxcciltivc file system commands. There is also an Executive command "FilcStat" that will tell 
you how big files are. Finally, a Non-Programmer's disk also has Bravo Bug and some sample 
documents and illustrations, which together occupy about 100 pages. They are pure fat - you 
almost never use them, and can retrieve them from appropriate servers when necessary. 

Perhaps this tirade on disk space seems superfluous - after all, a Non-Programmer's disk does have 
over 1600 free pages even with all this junk. True, but other disks are rarely so empty. Things get 
particularly tight on Mesa disks, so it is useful to know just what can be deleted and what can't. 
The preceding discussion gives you an introduction, but Mesa programmers have been known to go 
out much further on the limb in their quest for breathing space (e.g., deleting Swat, SYS.ERRORS, and 
related files that are only needed when the Alto is trying to tell you about a weird error condition). The moral is: 
know what's on your disk and why it's there. Delete "*$, Scratch*, and "^.scratch occasionally - it's 
amazing what you find lying around. 

In summary, then, we can categorize some commonly encountered files as follows: Files on the same 
line generally assume or require that their brothers and sisters exist. 

fissential files: 

Sys.boot SysDir DiskDescriptor Sysfont.al Swatee 
F.xecutive.run Com.cm Rem.cm User.cm 

Highly desirable: 
Sys.errors Swat 
MP.run FTP.log 
Bravo.am Bravo.error Bravo.mcssagcs (and various scratch files) 

Useail: 

Empress.nm Fonts.widths 
Neptune.run or DDS.run DDS.vmeth 
Laurcl.imagc RunMesa.run (and various .dl files) 
various .al font files 

Hook, Line, and Sinker 

Mow do you reel in those big fish we've just been talking about? With FTP. After Bravo, FTP is 
probably the most heavily used Alto subsystem, so it is well worth your while to learn something 
about its facilities. However, the documentation in [13] is sufficiently old that you should read the 
relevant section of {10} instead. We'll touch on the high points here. 

Full-blown FTP (there are half-blown versions) operates three windows on the Alto display, of 
which two arc interesting. The so-called "user" window is where you conduct your file transactions 
with another machine, often (btit not necessarily) a file server. The "Telnet" window provides you 
with a stripped-down version' of Chat, and is handy when you want to do somcliiing that just isn't 
covered by the file transfer protocol. Most of the time, however, tlic user window is all you ever 
look at (or through). There are commands to establish and destroy connections, to retrieve, store, 
delete, and rename files, and to interrogate directory contents and storage resources. 

Much of the flexibility of FIT is derived from its command line processor, which, in conjunction 
with the Executive's file name completion and ^-expansion, provides considerable fiexibility and 
power. With flexibility comes the ability to screw yourself with ease, so ITP implements a few 
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checks that prevent you from doing stupid things, at least without confirmation. You should read 
about the /N and /U switches remembering that, unless you can afford to maintain multiple 
versions, once you write on an Alto file, it's gone. 

Editing and Producing Documents 

In the outside world, document production systems are usually de-coupled from text editore. One 
normally takes the text one wants to include in a document, wraps it in mysterious commands 
understood by a document processor, feeds it to tliat processor, and puzzles over the resulting 
jumble of characters on tlic page. In short, one programs in the document processor's language 
using conventional programming tools - an editor, a compiler, and sometimes even a debugger. 
Programmers tend to think this is neat; after all, one can do anything with a sufficiently powerful 
programming language. (Remember, Turing machines supply a sufficiently powerful programming language too.) 
However, document processors of tliis sort frequently define bizarre and scmantically complex 
languages, and one soon discovers that all of the time goes into the cdit/compilc/dcbug cycle, not 
careftil prose composition. 

Bravo is a modest step away from the programming paradigm for document production. A single 
program provides the usual editing functions and a reasonable collection of formatting tools. You 
can't program it as you would a document "compiler", but you can get very tolerable results in far 
less time. The secret is in the philosophy: what you see on tlic screen is what you get on paper. 
You use the editing and formatting commands to produce on the screen the page layout you want. 
Then, you tell Bravo to ship it to a printer server and presto! You have a hardcopy version of what 
you saw on the screen. Sounds simple, right? 

Of course, it isn't quite that easy in practice. I'here are dozens of subtle points having to do with 
fonts, margins, tabs, headings, and on and on. Bravo is a success because most of these issues are 
resolved more or less by fiat - someone has prepared a collection of configuration parameters (in 

uijcr.cm) and a set of forms (on a Non-Programmer's disk and the MAXC <Forms> directory) that accommodate 
99% of the document production you have to do. Most of the configuration options aren't even 
documented, so it is hard to get enough rope to hang yourself, if you feel suicidal, there are always 
wizards about who can answer your every question about Hravo csotcrica. The net effect is that you spend much 
more time composing and much less time compiling. 

No one believes Bravo is the ideal solution; indeed, it has a lot of shortcomings that become 
evident as you begin to push on it. NeverUielcss, it is a sufficienUy large step forward that you will 
wonder how you tolerated the old way of doing things. (If this isn't obvious to you after reading 
[12] and [13], wait until you've used it for a few weeks.) You will also find that the availability of 
multiple fonts, paragraphing, automatic indentation, and other formatting facilities inside the text 
editor leads you to make prettier programs as well. It just isn't tliat much more work to create and 
maintciin attractive source text, and a simple set of formatting conventions can be a more potent 
program documentation aid than comments (see [11] for some examples). There are some operational 
annoyances with using Bravo formatting, however. The only program which can interpret Bravo formalting information 
and produce corresponding hardcopy is Bravo itself, and it can only do so on one file at a time and ralhcr slowly. 
I'mprcss is much faster, but can only handle prc-formattcd Press files or simple text (e.g., a sequence of ASCII 
characters). There is a Hardcopy subsystem that takes a list of files and feeds them one-by-onc to Bravo for haidcopying 
(it uses a Bravo macro [13] to eliminate manual intervention), but this is a kludge at best. I'hercfore, some people feel 
that Bravo formatting is just too much trouble and instead do it "by hand". They are a small minority. 
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When Bravo crashes 

Like all text editors, Bravo breaks once in a while. I'hcre is noticing quite like tiie sinking feeling 
you get wlien a large number of your precious keystrokes gurgle away down tlie drain. Wticn they 
do, you probably have an instinctive response (conditioned by previous editors you have used) to 
run the editor again to find out what state your file is in. Resisl this impulse al all costs - it is the 
worst thing you can do. 

Bravo has a "replay" mechanism, meaning that it records all of its actions in a file and is capable of 
replaying an editing session (yes, even one involving multiple files) from the beginning. However, 
all replay information is thrown away when liravo initializes unless you tell it that you wish to 
replay the immediately preceding session. If Bravo crashes on you, by diving into Swat or 
displaying "bootlights", your best bet is to re-boot your Alto, use I'TP to obtain BravoBug (unless, 
of course, you already have it), refresh your memory about how replays work [13], then run 
BravoBug. Bravo/r is not an acceptable substitute, despite a popular rumor to that effect! More 
details are available in [13]. The essential notion is that you must not run Bravo in the usual way, 
or you will forfeit your opportunity to do a replay. 

Square Pegs in Rhombic Holes - Alto Mesa 

For years BCPL was the only implementation language" for the Alto. Naturally, a nice cozy 
environment 9^ BCPL programs (and programmers) gradually developed, and the cognoscenti could 
guess how subsystems would behave in unusual cases because they knew that the programs operated 
in this environment. Then, along came Mesa and the end of innocence. Mesa programs cither 
have to mimic the behavior of the liCPL environment in situadons where they supply overlapping 
function, or risk being branded "incompatible". 

Okay, so that's a bit melodramatic. Neyertlxeless, Mesa is faced with the problem of adapting to an 
environment that it finds less than ideal. As subsystems coded in Mesa begin to emerge, subtle 
incompadbilities appear (e.g.. Mesa's inability, at present, to support version-numbered files). 
Mesa's more modern cipp roach to memory management (implicit segment swapping instead of 
explicit overlays) has the disadvantage of consuming considerably more disk space, largely because it 
has become much easier to ignore the constraints imposed by the Alto's small primary memory. 

Mesa is nevertheless the programming language for successors to the Alto. These machines have an 
architecture designed to support Mesa comfortably, and BCPL will quickly fade away when these 
machines arrive on tlic scene. Mesa today may be likened to a size 12 foot in a size 11 shoe. 

Smalltalk 

[I'his section was contributed by John Shoch.] 

Smalltalk is both a programming language and a programming environment, developed by the 
Learning Research Group with lots of help from other folks in CSL and SSL. I'he system has 
always been intended to serve as both a powerful language for use by experienced programmers and 
an easy language to be learned by children; some of the work of LRG has been aimed at testing 
out these systems with kids. 

As a programming language, Smalltalk is an "object-oriented" system which provides a uniform 
cpistcniology: 
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Every "object" is an "instance" of some "class". 

The class definition describes the behavior of all its instances. 

Objects communicate by sending messages. 



(Geneologists will recognize major parts of Simula and Lisp in our bloodline, combined with traces 
of many other languages,) 

But Smalltalk is more than just a language design -- it is a highly interactive, integrated system 
which tries to merge together many functions that are often viewed as separate subsystems: writing 
programs, editing text, drawing, real time animation, generation of music, and more. This view 
meshes well with the notion of a small, single-user personal computer (the "Dynabook"), and work 
continues to develop a truly portable Smalltalk machine. 

There have been many different releases of Smalltalk, but there have been two principal designs: 

1) Smalltalk 72, a fiilly interpreted version developed for the Alto, and used in some of 
the original work with kids. 

2) Smalltalk 76, a newer version incorporating the design of a virtual Smalltalk machine, a 
microcoded version of this on the Alto, a compiler to produce byte codes executed by 
the virtual machine, and an object-oriented virtual memory (called OOZE) upon which 
the whole thing sits. 

For more information, take a look at [22] and [23]. The "Smalltalk 72 Manual" is now both out of print and 
out of date, but did provide lots of interesting examples and discussion; try to borrow a copy from Someone. 

No Computer Scientist is an Island - the Laurel message system 

We rely very heavily on an electronic mail system. Since people spend much of the day at their 
Altos, notices posted on a central bulletin board are not likely to be seen rapidly. Accordingly, 
most announcements are broadcast (to expansive distribution lists), using our electronic mail system. 
If you don't check your messages once a day or so, you will soon find yourself out-of-touch (and 
saddled witli a mailbox full of obsolete junk mail). This business of using the message system for rapid 
distribution of announcements can got out of hand. One occasionally receives notices of the form: "meeting X will start 
in 2 minutes - all interested parties should attend". 

We also use the electronic mail system as a way of recording the progress of working groups and 
projects. Minutes of meetings, design documents, and related materials often pass as messages 
among group members. A file in which a copy of each such message is retained becomes a 
valuable archive of the project history and is quite painless to maintain. Many individuals keep 
archival files of their messages as well. 

fn the bad old days, the only generally available facility for sending messages was a Maxc subsystem 
called SNDMSG. A separate program, MSG, was commonly used to inspect and classify incoming 
messages. Consequently, people who had no other reason to use Maxc were compelled to process 
their mail there. 

The new kid on the block is an Alto-based message system named Laurel. {17} Regular Maxc 
users still rely primarily on MSG/SNDMSG, but Alto users now have no need to Chat to Maxc 
periodically to inspect their mail boxes. 'Ihcy do need Maxc accounts, however, to hold ihcir mailboxes. 
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However, because Laurel stores mail locally on the Alto "disk and requires a moderate amount of 
disk space (about 450 pages), most users find it necessary to dedicate a disk on which they process 
all their mail. If you like to read your mail frequently and you don't have a double-disk system, 
you find yourself switching disks a lot. 
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A Printing Discussion 

You might expect that Xerox Corporation might be more than a little interested in printing. 
Indeed, wc are so interested that we have created an array of printing facilities sufficient to confuse 
any new-comer. Let's try to understand the basics. 

First of all, diere is an important difference between copiers and primers. A copier obtains its input 
by scanning a physical image in some way. A printer obtains its input image in digital form from 
some external source, e.g., an interface to an Alto. 

I'hcre are a lot of printing programs about: Press, Spmcc, Empress. There arc a lot of printers 
too: Dover, Versatcc, . . . To make matters worse, each of the instances of each of these printers 
has a name as well: Clover, Menlo, Palo, Daisy. As you might expect, not all programs can talk to 
all printers, but we're working on that (see axiom 2 below). Here arc a few axioms that may help 
you reason logically about all this: 

1) There arc no line printers around here. All of our printers are built on top of Xerox 
copier printing engines that have been lobotomized and brainwashed to understand the 
babbling of an Alto instead of an optical input scanner. 

2) Press files arc tiic Kspcranto of documentation." Most printer servei-s demand that 
the documents you send them be in Press file format. 'ITiis means you have to convert 
whatever you have in hand (usually text) to Press format before a server will deign to 
print it. ^'here are several ways to do this. 

3) Press files aro liairy. Some printer servers don't support the full generality available 
in a Press file. Generally, however, such servers will simply ignore what they can't figure 
out, so you can safely send them any Press file you happen to have. 

4) There is m extensive collection of standard fonts, and they are mostly 
straightforward to use. Be prepared for a few surprises if you insist on building your 
own. 

In general, if you simply want to make a memo, or a listing of a program, or a copy of a 
documentation file that someone has sent you, things are quite straightforward. Bravo's hardcopy 
command [13] will take the file you arc editing, convert it to Press format (including all the 
formatting infonnation you have supplied), and ship it directly to any printing server you specify. 
The important server program to know about is Spruce, which understands everything Bravo can 
produce. Spruce can operate a Dover and a number of other printers, and is the server you will use 
for almost everything unless you arc a graphics hacker. 

Spruce will accept Press files from any source (though it does not implement all Press features). 
Standard documents and memos are typically stored in Press format, so you can ship them directly 
to your favorite Spruce server. From an Alto, use the Empress program; from Maxc, use the 
PRfsSS command. 

Empress can tell the difference between a Press file and a text file, and will convert a text file to 
Press format if necessary before sending it to the printing server. If you do this a lot, you will want 
to know about various options tliat apply to this conversion - see {10}. fn such cases, Empress uses a 
single fon(, which generally has a fixed pilch. This is the way we simulate a line printer. 
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Spruce servers have a collection of fonts stored locally. Press files do not contain the representation 
of the fonts they require, only their names. Naturally, if a Press file is produced using fonts that a 
Spnicc server doesn't have, tlie server will have a hard time printing it. Spruce v^ill attempt a 
reasonable substitution for unavailable fonts, and tell you about it on the break page of your listing. 
If you have chronic font difficulties of this sort, contact your local Spruce maintainer. 



Most frequently traveled paths through the printing maze 



Running on 

Maxc 
Alto 



Inputfile 
format 

Text 

Press 

Text 

Bravo 

Press 

Draw 

SIL 



Output 
desired 

Press file/printer 
Press printer 
Press file/printer 
Press file/printer 
Press printer 
Press file 
Press file 



Program 
to use 

PRESS command 

PRESS command 

Empress, Bravo. 

Bravo 

Empress 

Draw 

SIL 



A few caveats go along with this table. First, it is typically easier to format and print large files 
from Maxc (because of dislc space considerations) than from an Alto, but it often takes longer. 
Second, you should know that these various programs have a large number of options and defaults, 
and they are not always consistent. Beware of printing groups of files with *-expansion (particularly 
*.*) unless you are certain you are doing it properly. (LIST *.* is a disaster, for more reasons than 
you might think.) For more details about printing, and before you try to do anydaing clever, read 
{21}. 
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Beyond the Black and White Horizon - MAXC and the Arpanet 

Sitting at your Alto, you can easily forget about the other computing facilities that are within your 
grasp. Perhaps the most notable non-Alto on our network is MAXC, which is a home-grown 
microprogrammed processor masquerading as a PDP-10. Actually, we have two of them, Maxcl 
and Maxc2, implemented rather differently but software compatible. Both am Tenex. Both arc 
connected to the Arpanet, so it is possible for you to reach out to any machine connected to the 
Arpanet, at least in principle. In practice, not many people do (and ihcre arc restrictions imposed by our 
ARPA contract as well), except to send messages to people at other Arpanet sites. Laurel understands 
Arpanet names in messages, so you don't need to use Maxc directly for mail either. 

Maxc provides three essential services. First, at present, it serves as our only mailbox server. 
Second, it acts as a file server, archive facility, and software distribution center. Third, it provides 
the only computationally feasible place to run LISP. Few programming languages other than LISP 
are exercised on Maxc. 
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Looking under Rocks 

All Alto users should know about various- interesting files and directories. There is no coherent 
logic to the placement of "general interest" files and directories, but Maxc is the best place to start. 
Browse through the glossary at the end of this docurncnt to get a rough idea of what's around. 

Browsing on Maxc 

Ihe primary directories for documentation on Maxc arc <AltoDocs>, <lioc>, <PrintingDocs>, 
<Mcsa-[)oc>. As you can sec, the naming conventions aren't vei7 consistent, so you may have to 
fumble around a bit before you find tlie right one. The Tenex file name completer (KSC) can take 
some of live difficulty out of remembering, as can a quick glance in die glossary at the end of this 
document. 

Just because you don't find a particular file, don't give up! Tenex has an automatic facility called 
"archiving", which moves infrequently accessed files to tape. It sometimes happens that the 
documentation you are looking for has been archived. There is a Tenex command, "Interrogate^', 
that will help you locate an archived file - sec [9]. 

Maxc is still the file repository "of record", though that burden is gradually being shifted to various 
ll'"S servers. These servers frequeiuly have duplicate copies' of documentation, packages, subsystems, 
and the like, this is clone partly for redundancy and partly to decrease the load on Maxc when a new version of a 
popular Alto taciliiy is released. Duplicated directories always have the same name on IFS servers, but 
are not always scrupulously maintained, and therefore may be inconsistent, incomplete, or obsolete. 
J^roceed with caution. 

Browsing on IFS servers 

irS servers don't have an archiving facility (yet), which means that you arc less likely to overlook 
something interesting. ll'S supplies a general sub-directory structure which the Maxc file system 
lacks, and as a result there are many more pigeonholes in which to look. For example, on Maxc 
you might look for 

<AltoDocs>MyP'avoritcPackage.press 

while on IFS you would probably look for 

<Packagcs>Doc>MyFavoritePackagc.press 
<Packagcs>MyF'avoritePackage>Documentation.press 

or perhaps some other pcrniutation. This requires a bit of creativity and a litde practice. However, 
if you use the "Chat Executive" and get in the habit of using "^s in file name specifications, e.g., 

<Pcickages>*>*.press 

you will find all sorts of things you might not otherwise locate. 
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Code Phrases 

You may occasionally hear the following incomprehensible phrases used in discussions, sometimes 
accompanied by laughter. To keep you from feeling left out, wc offer the following translations: 

"Committing error 33" 

(1) Predicating one research effort on the success of another. (2) Allowing your own 
research effort to be placed on the critical path of some other project (be it a research 

effort or not). Known elsewhere as Forgic's principle. 

"You can tell the pioneers by the arrows in (heir backs." 

Mostly self-explanatory. Usually applied to the bold souls who attempt to use software 
systems in clever, novel, and therefore unanticipated ways ... with predictable 
consequences. 

"We're having a printing discussion." 

Refers to a protracted, low-level, time-consuming, generally pointless discussion of 

something peripherally interesting to all. Ilislorically, printing discussions were of far greater 
iniportaiice than they are now. You can sec why when you consider that printing used to be done by 
carrying magnetic tapes from Maxc to a Nova that ran an XGP. 

I'ontology 

The body of knowledge dealing with the construction and use of new fonts. It has been said 
that fontology recapitulates file-ogeny. 

"What you see is what you get." 

Used specifically in reference to the treatment of visual images by various systems, e.g., a 
liiavo screen display should be as close as possible to the hardcopy version of the same 
text. 

"Hey guys, up-level!" 

The conversation has degenerated to a discussion of nitty-gritty details. This phrase is 
often preceded or followed by: "We're having a printing discussioni" 

... smashed to zero 

A quaint way of saying diat some memory location acquired the value zero when it should 
had something else. "Smashed" is much preferred to "clobbered" in local argot, though in this context it 
seems about as appropriate as using a wrecking ball to stack bricks. 

"I,ife is hard" 

Two possible interpretations: (1) "While your suggestion may have some merit, I will 
behave as diough I hadn't heard it." (2) "While your suggestion has obvious merit, 
equally obvious circumstances prevent it from being seriously considered." ihe charm of this 
phrase lies precisely in this subtle but important ambiguity. 

"What's a spline?" 

"You have just used a term that I've heard for a year and a half, and 1 feel I should 
know, but don't. My curiosity has finally overcome my guilt." Moral: don't hesitate to 
ask questions, even if they seem obvious. 
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Some CSL Lore 

Here arc a few bits of information specific to CSL that you should know: 

CSL has a weekly meeting on Wednesday afternoons called Dealer. The name comes from the 
concept of "dealer's choice" - the dealer sets the ground rules and topic(s) for discussion. When 
someone says he will "give a Dealer on X", he means that he will discuss X at some future weekly 
meeting, taking bout 15 minutes to do so (plus whatever discussion is generated). Generally, such 
discussions arc informal, and presentations of half-baked ideas are encouraged. The topic under 
discussion may be long-range, ill-formed, controversial, or all of the above. Comments from the 
audience are encouraged, indeed, provoked. More formal presentations occur at the Computing lorum on 
'I'hursday afternoons, which is not spccifiailly a CSL function and is open to all Xerox employees. Dealers arc also 
used for announcements which arc not appropriate for distribution by electronic mail. 

Once a month, normally on the first Wednesday, Dealer is extended and becomes CSL Luncheon. 
On tliesc occasions, we have a tasty buffet lunch amidst bean-bag splendor, and Mother Xerox picks 
up the tab. 

The CSL Archives (not to be confused with TENLX archives) arc a collection of file cabinets and 
3-ring binders that provide a continuing record of CSL technical activities. The archives are our 
primary line of defense in legal matters pertaining to our projects, but they make interesting reading 
for anyone curious about the history of any particular project. You will find it most informative to 
browse the archives from time to time, just to see what's been going on in those projects you just 
haven't quite had the time to monitor. Ask someone to point you at the cubicle where the archives 
are stored. 

If you are a CSL member and need a new disk pack, see Mike Overton in the CSL lab (across fiom 
the Commons). 
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Some SSL Lore 

Here arc a few bits of information specific to SSL that you should know: 

The work of tlic System Science Laboratory spans a wide range of computer-related research, 
organized into several projects including: the Learning Research Group (LRG), the Office 
Research Group (ORG), LSI Area, Applied InfoiTnation Processing Psychology (A IP), a Graphics 
project, and the Engineering and Software Group. 

A Lab-wide meeting is often scheduled on one afternoon each month or two, usually accompanied 
by something delicious to cat (plan ahead - find out if a particularly extravagant pastry will be 
served, and you can skip dessert at lunch!). 
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A Glossary of Alto Terms, Subsystems, Directories, and Files 

(and ncronyins, protocols, aiK) oilier trivia) 



Note; For users in Palo Alto, Maxcl is the file server on which inost of the directories described 
below reside. Other locations have equivalent directories on their local file servers (IFSs). 



<Alto> A directory on which standard Alto (BCPL) programs and subsystems are 

stored. Only object code files (extension .BR) and runnable files (extension 
.RUN) are stored here; source files and documentation are stored on 
<AltoSource> and <AltoDocs>, respectively. 

<AltoDocs> A directory on which documentation for Alto programs is stored. Common 

extensions are .PRESS (for files directly printable by Press or Spruce), and 
.TIT (ASCII). See <AltoSourcc> and <Alto> for corresponding source and 
object files. 

<AUoFonts> A directory on which screen fonts for the Alto arc stored (extension .AL). 

<AltoSource> A directory on which source versions of standard Alto programs are stored. 

Corresponding object versions and documentation are stored on <Alto> and 
<AltoDocs>, respectively. 

ASD Acronym for Advanced Systems Department, a part of XBS. 

bar A generally thin, generally rectangular, generally invisible region of the screen 

in which certain generally display-related actions occur, e.g., the scroll bar, 
tlic line-select bar. 

BCPL A system programming language used as the basis for many Alto facilities. 

Also, the compiler for that language. 

BITBLT (prounouced "bit-blit"). A complex Alto instruction used for moving and 

possibly modifying a rectangular biUnap. The "BLT" part is an acronym for 
BLock Transfer. 

bitmap Generally refers to a representation of a graphical entity as a sequence of bits 

directly representing points. The Alto display hardware and microcode 
process what is essentially a bitmap of the image to be displayed. 

boot Short for "bootstrap", which is in turn short for "bootstrap load". Refers to 

the process of loading and starting a program on a machine whose main 
memory has undefined contents. 

boot button The small button behind an Alto keyboard used (sometimes in conjunction 

with tlie keyboard) to boot some program into execution. 

boot server A coniputcr on the network that provides a retrieval service for certain stand- 

alo!!C programs. Sec NetExcc. 
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bootlights 

Rravo.run 
BravoBug.run 

Cedar 

Chat.nin 

Clover 
Com.cm 

CopyDlsk.run 

CSL 

Daisy 

DDS.run 

DiskOcscriptor 

DLISP 

DMT.boot 

Dorado 

Dover 

Draw.run 



A screen pattern resembling a city skyline. Occurs occasionally when some 
erroneous unanticipated condition arises, e.g., getting a parity error in a 
BCFL program on a disk that doesn't have Swat. 

An integrated text editor and document formatting program diat runs on the 
Alto. 

A program used when Bravo crashes to replay the editing actions up to the 
point of the crash, and/or to report the problem to a (nominally responsible) 
person. 

A large project in CSL revolving around an experimental programming 
environment for essentially all of CSL's applications. 'I'hc system is based on 
the Mesa programming language and many ideas from the IntcrLISP 
programming environment. 

A subsystem that pennits teletype-like, interactive access to a remote 
computer on the network. Used also to refer to a fecility resembling that 
provided by this subsystem, e.g., FTP is said to have a Chat window. Chat is 
mainly used to communicate with Maxcl, Maxc2, and IFS servers. 

A Dover used primarily by CSL. 

A file used by the Alto Executive to store the current command being 
executed. See Rem.cm. 

A stand-alone program used to transfer the entire contents of a disk. May be 
used between computers or on a single computer with multiple disk drives. 

Acronym for Computer Science Laboratory, a part of PARC. 

A Dover used primarily by SDD/Palo Alto. 

Acronym for Descriptive Directory System. An Alto subsystem providing 
more sophisticated manipulation of the file system than is available with the 
FACcutivc. See also Neptune, which is a poor man's DDS: it provides most 
of the functionality but uses less disk space and time. 

A file that contains the disk allocation information used by tlic Alto file 
system. 

A version of InterLISP running on Maxc that communicates with some fancy 
display manipulation facilities on the Alto. 

Acronym for Dynamic Memory Tester. A memory diagnostic for the Alto. 
DMT is automatically booted from the network by the Alto Executive after 
die Alto has been idle for about 20 minutes. 

A high-performance computer being designed and built by CSL and intended 
to execute Mesa, Lisp, and Smalltalk programs very rapidly. 

A laser-scan printer built on the Xerox 7000 xerographic engine and 
connected to an Alto by means of a Orbit interface. Successor to EARS. 

An Alto subsystem that permits interactive construction of pictures composed 
of lines, curves, and text. 
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Dutnpcr.boot 
DWIM 
EmPrcss.run 
Ethernet 



Exccutive.run 
file extension 



file server 

FLG 

fog index 



A file used for desperation debugging. Dumps (most of) tiie current core 
image to Swatcc for subsequent inspection by a debugger. 

Acronym for Do What I Mean. Also, a facility intended to make LISP do 
what you mean, not what you say. 

An Alto subsystem used to convert text files to Press format and ship them 
to a Press printer server. 

The communication line connecung several Altos (or other computers with 
compatible interfaces) together. Strictly speaking, an Ethernet is a single, 
continuous piece of co-axial cable, but the term is sometimes (incorrectly) 
applied to the entire network accessible through the cooperation of Gateways. 
E^vcry Ethernet within a (connected) network has a unique identifying 
number. 

A distinguished Alto subsystem that provides simple commands to inspect 
and manipulate the file system directory, and to initiate other subsystems. 

The portion of a file name tliat appears following a period (possibly null). 
By convention, a number of extensions are reserved to indicate tlio type of 

data in the file, though not ail subsystems are consistent in their defaulting of extensions. 

Some commpnly encountered extensions are: 

~ an Executive command (not really an extension) 

al Alto screen font 

bed Mesa object program module 

bcpl BCPL source program module 

boot program invokablc by boot button 

br BCPL object program module 

bravo text file containing Bravo formatting information 

cm Executive command file 

dl Laurel distribution list 

dm dump file (i.e., several logical files stored as one) 

error(s) Swat error message file 

image executable (Mesa) program 

log history of certain program actions 

mail Laurel mail file 

mail-dmsTOC I-aurcl table-of-contents file 

run executable (BCPL) program 

mesa Mesa source program module 

press Press file 

st Smalltalk source program text 

symbols Mesa symbol table (for debugging) 

syras BCPIv symbol table (for debugging) 

ts, typescript typescript file (log of interaction) 

A computer on the network that provides a file storage and retrieval service. 
MAXC and IFS are two different types of file server, thougli they provide 
related facilities. 

(pronounced "Aug"). A switch (usually in Lisp programs) that customizes a 
program's behavior to an individual user's working habits. 

A measure of prose obscurity. Units are years of education required for 
understanding. 
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font An assortment of characters all of one size and style. 

<Fonts> A MAXC directory containing fonts used for printing (in Press files), as well 

as Fonts.widths. 

Fonts.wi(iths A file containing character-width information for a large number of fonts. 

Used by many programs on the Alto that manipulate multiple fonts. 

<Forms> A MAXC directory containing files that are usable as templates (in Bravo) for 

various kinds of documents (e.g., memos, letters, reports). 

FTP.run Acronym for File Transfer Protocol (or Program). An Alto program that 

provides a convenient user interface to the file transfer protocol, enabling the 
transfer of files between co-operating computers on the network. 

Gateway A computer serving as a forwarding link between separate Ethernets. 

Gateways may also perform certain server functions, such as name lookup. 

IFS Acronym for Interim File System. An Alto-based file server. Several distinct 

IFS servers exist on various Ethernets, including Ivy, Iris, and Isis. 

install A term applied tp the Alto Operating System and a number of subsystems 

(notably Bravo), referring to a procedure whereby certain configuration 
options are established. 

IntcrLISP An interactive version of Lisp with a large hbrary of facilities and a 15-pound 

reference manual. 

Iris An IFS server in SDD/Palo Alto. 

Ivy An IFS server in PARC. 

Juniper A CSL project and system exploring issues in the design and construction of 

a distributed file system. 

Junta A technique for eliminating layers of the Alto Operating System that are not 

required by a particular subsystem. 

KBA Acronym for Knowledge-Based Assistance. Refers to an on-going project in 

Co I J. 

KRL Acronym for Knowledge Representation Language. Refers to an on-going 

project in CSL. 

Lampson A unit of speech rate. 1 Lampson is defined as Butler's maximum sustained 

speed. I'or practical applications, the milllLampson is a more appropriate 
unit. 

Laurcl.iniage An Alto-based, display-oriented message system. 

level i system (for i € [1..3]). A terminology for classifying (software) systems according to 

their intended user community: 

1 implementors only 

2 implementors and friendly users 

3 naive users 
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LRG 

Markup.run 

MAXC 

Menio 
menu 

Mesa 

<M(5sa> 

<McsaLib> 

name lookup 

name lookup server 
Neptune 

NetExcc.boot 

network address 
Orbit 

OS 

PARC 
Phogg,image 



Acronym for Learning Research Group, a part of SSL. 

An Alto subsystem for editing Press files. 

Acronym for Multi-Access Xerox Computer (pronounced "Max"). The 
generic name given to local implementations of a computer fimctionally 
similar to the DEC PDP-10. When used in reference to a specific machine, 
MAXCl is usually intended. 

A Dover used primarily by SSL. 

A collection of text strings or icons on a display screen generally used to 
represent a set of possible actions. 

A PASCAL-like, strongly typed, system programming language developed by 
PARC and SDD. 

A directory on which Mesa programs (source and object) and documentation 
are stored. Additional facilities of interest to Mesa programmers may also be 
found on <MesaLib>. 

A directory on which Mesa utilities and packages (source, object and 
documentation) are stored. Standard Mesa programming facilities may be 
found on <Mesa>. 

In the context of network communications, the process of mapping a string of 
characters to a network address. Also, the protocol tliat defines the 
mechanism for performing such a mapping. 

A computer that implements the name lookup protocol. 

An Alto subsystem providing more sophisticated manipulation of the file 
system than is available with the Executive. See also DDS, which provides 
still more bells and whistles at the expense of time and space. 

A mini-Executive usable without a disk and obtainable directly from the 
Ethernet (from a boot server). The NetRxcc makes available a number of 
useful stand-alone programs, including CopyDisk, Scavenger, FTP, and a 
number of diagnostics. 

A pair of numbers <network number, host number> that uniquely identifies 
any computer on the network. 

A high performance image generator designed to merge soiu'ce rasters into a 
raster output stream for a SI^OT printer (e.g., Dover). So named because it 
ORs bits into buffers. 

Acronym Ibr Operating System. Generally used to refer to the Alto 
Operating System, which is stored in tlie file Sys.boot. Rarely used locally to 
refer to the operating system of the same name that runs on IBM 360/370 
computers. 

Acronym for Palo Alto Research Center. 

A program that computes the fog index for a piece of prose text. 
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Pine 

plaid screen 

FLAP 
Poplar 

Press 

Press Edit.run 

printer server 

<Printin8> 
<PrintingDocs> 

products 



PUP 

Rcm.cm 

replay 
Scavenger.boot 

scroll 



Sec PJ.AP. 

Occurs when certain Icinds of memory smaslies overwrite the display bitmap 
area or control blocks. The term "salt &. pepper" refers to a different pattern 
of similar origin. 

Acronym for Page Level Access Protocol. Sometimes called Pine. 

An interactive programming language system running on the Alto, an 
experimental system in the dirtction of programming by relatively naive 
users. Useful for text manipulation applications. 

A file format used to encode documents for printing and editing. Also, a 
printing server capable of obeying all the specifications present in a Press file. 

A subsystem that recombines Press files on a page-by-page basis. PressEdit 
can also convert an .ears file to Press format. 

A computer that provides printing services, usually for files formatted in "a 
particular way. The term also refers to the specific software that converts 
such files into a representation that can be processed by a specif" printer 
hardware interface. Spruce is an example of a printer server program. 

A MAXC directory containing printing and graphics programs. 

A MAXC directory containing documentation related to printing and graphics 
facilities such as Press files and fonts. 

The following is a list of the most commonly encountered Xerox product 
numbers and their distinguishing characteristics: 

800 typewriter-based, word-processing terminal 

850 display-based, word-processing terminal 

2600 desktop copier 

3100 3 sec/page copier, good solid black-area development 

4500 1 sec/page copier, 2-sided copying 

5400 1 sec/page copier, good resolution 

6500 20 sec/page copier, color copying 

7000 I sec/page copier 

9200 offset-quality, .5 sec/page copier 

9700 offset-quality, .5 sec/page, laser-scan printer 

Acronym for PARC Universal Packet. The structure used to transmit blocks 
of information (packets) on the Ethernet. Also, one such unit of information. 

A file used by the Alto Executive to store commands to be interpreted after 
the current one has completed. See Coin.cin. 

Refers to a Bravo facility that permits recovery after a crash. Sec RravoKug. 

A program available through the NetExec that checks for damaged file 
structures on an Alto disk and tries to repair them. 

Refers to a method of repositioning text on a display as though it were part 
of a long, continuous sheet of paper. 
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SOD 
SIL.run 

<Sccrctary> 

server 

Smalltalk 
Spruce 

SSL 

<SubSys> 

subsystem 

Swat 

Swatee 

Sys.boot 
SysDir, 
SysFont.al 
Telnet 

Teucx 

thumbing 

typescript 



Acronym for System Development Division, a part of XBS. 

Acronym for Simple ILlustrator. An illustrator program used for logic design 
and drawing in general. 

A MAXC directory containing standard distribution lists for use with Laurel 
and SNDMSG. 

A computer dedicated to performing some collection of service functions for 
the communal good (e.g., a printer server). 

An integrated programming system for the Alto developed by LRG. 

A program that recognizes certain portions of a Press file (primarily text and 
bitmaps), converts them to a form acceptable by an Orbit interface, and prints 
them. 

Acronym for System Science Laboratory, a part of PARC. 

A MAXC directory containing standard TENEX subsystems. 

A program running under a specific operating system. Normally used to 
refer to Alto programs that run under the Alto OS, but also used to refer to 
PDP-10 programs diat am under TENEX. 

A debugger used primarily for BCPL programs. Also, the key used in 
conjunction with the "control" and "shift" keys to invoke the debugger. 
Used as a verb to refer to tlie act of striking these keys or entering the 
debugger. 

A file used by debugging programs (both Swat and the Mesa debugger) to 
hold the core image of the program being debugged. Also used as a scratch 
file by many Alto subsystems. Not to be deleted under any circumstances. 

An Alto disk file containing the executable representation of the Alto 
Operating System. 

The Alto file directory. Roughly speaking, this file contains the mapping 
from file names to starting disk locations. 

An Alto screen font used by the Executive and (generally) as a default by 
other programs. 

A PUP-based protocol used to establish fijll-duplex, teletype-like 
communication with a remote computer. (The term is borrowed from a 
similar protocol used on the Arpa network.) Chat speaks this protocol. 

An operating system for the DEC PDP-10 computer, which also runs on 
MAXC. 

A technique of positioning a file (usually text) to an arbitrary position, 
usually for viewing on a display. 

An Alto file used to back-up information (usually text) appearing in a region 
of the display. 
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uscr.cm A file containing a number of logically distinct sections that each define 

certain configuration parameters (e.g., the location of a preferred printer 
server for a particular file format). Programs that interpret such parameters 
are often organized to read user.cm only at installation time (e.g., Bravo). 

window A display region, usually rectangular, used to view (a portion of) an image 

that generally exceeds the bounds of the region. 

XBS Acronym for Xerox Business Systems. 

XGP Acronym for Xerox Graphics Printer. An obsolete, low-resolution continuous 

paper, xerographic printer. 
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References 

Reference numbers in [square brackets] arc for conventional, hardcopy documents. Reference 
numbers in {curly brackets} are for on-line document files. The notation used for on-line files is: 
[FilcScrver]<Dircctory>SublDirectory>FileName.Extension . 

F.ach reference is followed by a brief description of what you can expect to find in the cited 
document. 

If you can't find some of the on-line files, they may have been archived. See the section on 
"Looking Under Rocks". 

{1} [Maxc]<A]toDocs>AltoHardware.prcss 

[2] Metcalfe, R. M. and Boggs, D. R. Ethernet: Distributed Packet Switching for Local 
Computer Networks. Communicalions of the ACM 19, 7 (July 1976), pp. 395-404. A 
description of tiie Ethernet's functional organization, with a discussion of error recovery 
strategies. 

{3} [Maxc]<AltoDocs>AltoNetwork.press. Contains a one-page picture of the entire network 
configuration. 

{4} [Maxc]<Pup>FTPspec.press. A functional specification of the file transfer protocol, 
independent of implementation in any particular language or system. 

{5} iMaxc]<Pup>EFTPspec.press. A functional specification of the "easy" file transfer protocol. 

{6} [Maxc]<Pup>Telnet.press. A fijnctional specification of a protocol for interactive teletype- 
like communication between computers on the network. 

{7} [Maxc]<Pup>MiscServices.press. Describes a variety of simple protocols (usually a single 
exchange of packets). 

[8} [Maxc]<AUoDocs>OS.press. The programmer's reference manual for the Alto Operating 
System, including detailed information on the services provided and the interface 
requirements. 

[9] Myer, 'V. H. and Barnaby, J. R. TENEX Executive Language Manual for Users. Available 

from Arpa Network Information Center as NIC 16874, but in the relatively unlikely event 
that you need one, borrow one from a Tenex wizard. 

{10} [Maxc]<AltoDocs>SubSystems.press. Documentation on individual Alto subsystems, 

collected in a single file. Individual systems are documented on 

[Maxc]<AltoDocs>systcmname.TTY, and these files arc sometimes more recent than 
SubSystems.press. 

[11] Morris, J, H. The Elements of Mesa Style. Xerox PARC Internal Report, June 1976. 
. Somewhat out of date (since Mesa has changed under it), but a readable introduction to 
some useful program structuring techniques in Mesa. 

[12] Jerome, Suzan. Bravo Course Outline. Xerox PARC Internal Report, undated. Oriented 
to non-programrners. 

[13] Alto User's Handbook. Xerox PARC Report, November 1978. An introduction to Alto 
facilities and reference documentation for several commonly used subsystems, including 
Bravo, Laurel, FTP, Draw, Markup, and Neptune. 
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[14] Sunset Western Garden Book. I^nc Magazine and Book Company, Menlo Park, Ca. The 
definitive document on Western gardening for non-botanists. 

{15} [Maxc]<Pup>GatewayInformation.press. Describes the protocol for obtaining packet routing 
information from die Gateways. 

{16} [Maxc]<Pup>Pup.press. A ftmctional specification of the PUP mechanism for packet-based 
communication on the network. 

{17} [Maxc]<DMS>Laurel.press. Documentation for the Alto-based, electionic mail system. 

{18} On-line documentation for Smalltalk is (always?) in a state of flux. Consult a member of 
LRG for a current pointer. 

[191 Maybury, W. and Mitchell, J. G. Mesa Language Manual. Xerox PARC Internal Report, 
October, 1977. A cross between a tutorial and a reference manual, thougli much closer to 
the latter than the former. Details of the Alto implementation appear in other,' on-line 
documentation - look on [Maxc]<Mesa>. 

{20} [Maxc]<AltoDocs>AltoUscrsPrimer.prcss. A more complete (and neutral) introduction to 
AU.>-land, intended at least in part for non-programmers. 

{21} [Maxc]<PrintingDocs>Printing.press. The "entry document" for printing services on Maxc 
. and the Alto. 

[22] Kay. A. C. "Microelectronics and the Personal Computer". Scientific American. 
September, 1977, pp. 230-244. 

[23] Personal Dynamic Media. Xerox LRG/SSL report 76-1, 1976. 
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Printer Dover 
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brightness, hue, 



saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation. 
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show 
show- 
show 
show- 
show 
show- 
show 



object, show 
object, show 
object, show 
object, show 
object, show 
object, show 
object, show 
object, show 



■dots-opaque, 
■dots-opaque, 
■dots-opaque, 
•dots-opaque, 
■dots-opaque, 
■dots-opaque, 
-dots-opaque, 
■dots-opaque. 



dots from files 
dots from files 
dots from files 
dots from files 
dots from files 
dots from files 
dots from files 
dots from files 



Reprinted with the permission of Xerox Corporation for dlstrltnitlon within the Stanford 
University Department of Computer Science. Not to be ro'sold, duplicated, or otherwise 
distributed. 
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]. Introduction 

This document is. intended to tell you what you need to know to create, edit, and print text and 
pictures on the Alto. It doesn't assume that you know anything about Altos, Maxc, Ifs, or any of 
the other facilities available to you. 

You will find that things arc a lot clearer if you try to learn by doing. This is especially true when 
you arc learning to use any of the services which use the display. Try out the things described here 
as you read. 

Material in small type, like this paragraph, deals with fine points which can be skipped on first reading (and perhaps on 
subsequent readings as well). 

Much of the documentation in this Guide is intentionally incomplete. More comprehensive 
information about almost all of the programs and services described here may be found in various 
on-line documents. Section 9 contains a summary of these and instructions for obtaining your own 
copies of any that you need. 
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2. Getting started 

To do anything with an Alto, you must have a disk pack. This is a circular, yellow or white object 
about 15 inches in diameter and 2 inches high. Your secretary can tell you how to obtain a new 
one from the stock kept by your organization. 

INI'IIALIZE YOUR DISK 

The next step is to get the disk initialized with copies of all the programs you will need to use. 
Here is how to do this: 

Obtain the disk pack labeled Basic Non-programmer'S Disk. Find an Alto that has two disk 
drives, each with four square lights, a white switch and a slanted plastic window. Load the Basic 
Non-programmer'S Disk into the drive labeled 0. You do this as follows: 

The drive should have the white switch in the load position, and the white load light 
should be lit. Open the door by pulling down on tlie handle. Put in the disk by holding it 
Bat, with the label facing you, and pushing it gently into the drive until it stops. Then gently 
close the door and push dac white switch to RUN. The white load light will go out, md 
after about a minute the yellow RUN light will go on. The disk is now loaded and ready to 
go. If anything else happens, you need help. 

On many double-disk Altos, the two disk drives are not labelled. The drive mounted inside the same cabinet as the Alto 
is drive 0, and the one sitting on top of the cabinet is drive 1. Also, some Altos have a switch on the back of the 
keyboard housing labelled NORMAL/ALTERNATE. Re sure that this switch is in the NORMAL position. 

Now Start die Alto. This is done by pushing the small button on the back side of the keyboard, 
near the thick black cable. Pushing this button is called booting the Alto. It resets the machine 
completely, and starts it up working on the disk you have just loaded. After you boot the machine, 
it will tell you at the top of the screen what it thinks the state of its world is, and dien it will print a 
">" about halfway down the screen. When the screen looks like that, anything you type will be 
read by the Executive, whose basic job is to start up tlie service you want to ran. There is a section 
on the lixecutivc later in this document. For now, you will find everytliing you need to know right 
here. 

You are going to use a program called CopyDisk, which copies everything on the main disk (which 
you just loaded) onto another disk which you will load into the disk drive labeled 1. This copying 
erases anything which is already on the disk in disk drive 1, so you should be very careful not to 
copy onto a disk which has anything you want to keep. Load your new disk into Uie disk drive 
labeled 1, doing just what you did to load the BASIC Non-programmer'S Disk into drive 0. 

The CopyDisk program is not present on the Basic Non-programmer'S Disk, but it is available 
through a service called the Nettixec, which can load a small number of commonly-used programs 
from the Ethernet. To start the NctExec, type 

> NctExecCR 

Tiic '-'^ stands for the carriage return key on the keyboard. In this and later examples, what you 
type is underlined in the example, and what the Alto types is not. On the screen, of course, there 
won't be any underlining. It doesn't matter whctlier you capitalize letters or not; the capitalization 
in this manual is chosen to make reading easier. 

Within a few seconds, the NetExec will start up. The screen will look much the same as it did 
while the Executive was amning, but with "Net Executive" in the upper left corner. Now type 

> CopyDiskCR 

After a few more seconds, CopyDisk will start up, identify itself, and display a prompt of "*". You 
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should now go through the following dialogue: 

*Copy from: DPOCR the digit zero, not the letter O 

Copy to: DPLCR 

Copying onto DPI will destroy its old contents. 

Are you sure this is what you want to do? [Confirm] Yes 

Are you still sure? [Confirm] Yes 

Now CopyDisk will copy the contents of the Basic Non-programmer's Disk (dpO, "the O'sic 
l^ack in drive 0") onto your new disk pack (dpI), This takes about two minutes. While it is 
running, it records its progress by moving the cursor from the top of the screen to the bottom; this 
happens twice: once while the disk is being copied and again while the copy is being checked for 
correctness. When it is done, if all went well it will display the message "Done. DPO and DPI are 
now identical." followed by the "*" prompt. Now type 

* OuitCR 

to exit CopyDisk and return control to the Executive, if something goes wrong, the message "Copy complete, 
but do not tnist DPI" will appear. This means that there is something wrong cither with the Alto or with one of the 
disk packs. Consult your local support staff. 

Now you ran take both disks out of the machine. Before you do, you should tell the Executive that 
you are finished, by typing 

> QuitCR 

You will sec that after a couple of seconds the screen goes blank and starts to display a white 
square that jumps around. This is an indication that the memory test program is ainning properly; 
an Alto should always be left in tliis state when it is not being used. 

Now take out both disks, by pushing the white switch on each drive to load. The yellow ready 
light should go out, and about 25 seconds later the white LOAD light should go on. Now you can 
open the door (against a slight resistance) and remove the disk. Put the Basic Non-programmeR'S 
Disk back where you found it 

If you cannot find an Alto with two dsk drives, you can do a CopyDisk from one standard (single-drive) Alto to 
another; the procedure for doing this is (escribed in section 8.6. Since it is a little more complicated than the method 
just given, a novice should use it oily as a last resort. 

Label your disk 

Before doing anything else, put a label on the new disk with your name, and any other identifying 
irtfonnation you like. This is best done by preparing a paper label that can be slipped underneath 
tlic plastic insert on the front edge of tiie disk pack. Now you can take the new disk to any Alto, 
load it in, boot the machine by pushing the button on the back of the keyboard, and start working. 

Name your disk 

When you do this, if you look at the information displayed at the top of the screen just after you 
do the boot, you will sec that it says 

— - OS Version x/x Alto #xxx NoName — - Basic Non-programmer's Disk -— 

This is because your new disk is an exact copy of the Basic Non-programmI'R'S Disk, which has 
no owner, and owner and disk name information got copied along witii everything else. To give the 
disk your own name as owner, you should type 

> [nstallCR 

to the F-Accutive. It will ask you whether you want die "long installation dialogue"; answer No. 
When it asks you for your name, type in your Maxc or Ifs account name (usually just your own 
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last name), followed by a CR. When it asks you for a disk name, choose a suitable one and type 
that in, again followed by a CR. Next it will ask you whether you want to give your disk a 
password, if you do this, the Alto will ask you for the password every time you boot it, and won't let you do 
anythine until you provide it correctly. This provides a modest level of security for the information on your disk. If 
you do give your disk a password, it is best to use your Maxc or IP'S password, since the Alto will then know it and use 
it autoniatically whenever you communicate with Maxc or II'S. Don't forget the password, since there is no simple way to 
find out what it is, and you will need an expert to get access to anything on your disk 

There will be a pause for a few seconds, and then the Executive will come back, if you assigned a 
password to your disk, you vwll be asked for it first. Now your name is installed on the disk, and the system 
will display it near the top of the screen whenever tlie Executive is in control, and will put it on the 
cover page of anything you print. 

After you initialize a disk, you have to edit your user profile, discussed in section 2.4 of the Bravo 
manual, and your Laurel profile, described in section 3.6 of the Laurel manual. If you arc reading 
this manual for the first time, you will be told how to do these things at the appropriate points. 
This is mentioned here so that you will remember it next time you initialize a disk. 



3. Tlie Executive and the NetExec 

The Executive is the program to which you arc typing right after a boot, and whenever any other 
program finishes its job. It has a large display area in the middle where your typing and the 
Executive's responses appear. Above this the Executive displays a digital clock and some other 
useail status information: the versions of the Executive and the operating system, the owner name 
and disk name installed on the disk, die Ethernet address of the Alto you are using, and the 
number of free pages on the disk. Whenever you call another program, the Executive's display is 
erased and replaced by that of the program that you called. 

3.1 Correcling typing errors 

When you are typing at the Executive and you make a mistake, diere arc a few special keys you can 
type to correct the mistake. The BS (backspace) key erases the last character you typed. Holding 
down the ClRL key and typing W erases the last word you typed. The act of holding down CTRL 
and typing W is called control-W and is denoted by W^ and similarly for odier conti'ol characters. 
The Di-L key cancels the command you were typing completely; it prints "xxx", and then starts a 
new line with a fresh ">" character. Nearly all programs accept A*^ (comrol-A) as a substitute for BS. 



3.2 Starting a program 

As we said before, the Exccudvc is for starting up other programs which do the work you want 
done. To start a program called Alpha, you just type 

> AlphaCR 
It doesn't matter whether you type in capitals, lower case, or a mixture of the two. If the program 
needs some other information about what to do, you type that after the name of the program. For 
example, there is an lixecutive cornmand to type out a document on the screen. Suppose you want 
to type out the document called "Notes". You just say 

> Typc NotesCR 

'ITic Exccudve won't ever do anything until you type the final Cr; if you change your mind, just 
type DEL to cancel the coinmand any time before you type the CR. 
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Certain operations, sucii as Type, are perfonncd entirely by the Executive itself, whereas most others are performed by 
separate programs (also called subsystems) kept on your disk or obtained from the Ethernet Ignore this distinction for 
now. 

3.3 Aborting 

You can usually stop what is going on and get back to tlie Executive by holding down tlic left-hand 
SHUT key and striking the swat key, which is a blank key in the lower right corner of the 
keyboard on Alto-Is, in the upper right corner on Alto-Ils. If this doesn't work, you can push the 
boot button. 

If you push the SWAT key while holding down both CTRL and SHUT, you will fmd yourself talking to a service called 
Swat which is of no interest to non-programmers. Usually no harm is done if this happens; you can get back to what 
you were doing before by typing PC (control-?; hold down the CTRL key and type P). 

3 J The NetExec 

The NetExec is a program much like the Executive in that its main purpose is to sta'-r up otiier 
programs for you. Unlike the Executive, it loads programs from a boot server available via the 
Ethernet rather than from your own disk. The NetExec. makes available certain programs (such as 
hardware diagnostics) tliat arc used infrequeiitly and that most users won't wish to keep on their 
own disks. Also available are several programs useful for recovering from various sorts of disasters 
that may make it impossible for you to invoke the normal Executive. 

The NetExec may be started in either of two ways. If the Executive is already running, you may 
simply type 

>NetExecCR 

A fuzzy cursor will appear in the center of the screen for a few seconds, and then the NetExec will 
start up. If the Rxccutive is not running, you can invoke the NetExec directly by holding down the 
BS key and ttic ' (quote) key and then pushing and releasing the boot button. Keep the keys 
pressed down until you see a fuzzy cursor in the center of the screen; this can take up to 5 seconds. 

The NctExec's display looks much like the Executive's, but the herald contains the words "Net 
Executive". The type-in conventions are identical to the Pixecutive's. To start up a program from 
the NetExec, simply type the name of that program followed by CR. 

Any time this manual instincts you to "use the NetExec to invoke p", where p is the name of some 
program, you should follow the above procedure. An example of this was given in the instnictions 
for using Copy (Disk to initialize your disk (section 2). 

The I-xecutive also has a few commands for invoking programs directly from the lUhernet, without your first having to 
start up the NetExec. At the present time, these programs are Chat, [TP, and Scavenger. More precisely, Uiese 
commands will obtain the correspondingly-named programs from your disk if they are present and from the fvthernet 
otherwise. 
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4. Files 

'l"he Alto stores on your disk all of the material you are working on (text and pictures), as well as 
most of the programs which provide the various services described here. The named unit of storage 
on the disk is called a file. Hach different document you handle will be stored on its own file. The 
facilities for identifying files arc not ideal, but you will get used to them after a while. Better 
facilities are the subject of current research. 

A file is identified by its name, which is a string of letters (upper and lower case can be used 
interchangeably), digits, and any of the punctuation characters +-.!$. A file name can have two 
parts, which are called the main name and the extension; they are separated by a period. For 
example, "Alto.Manual" is a file name, with main name "Alto" and extension "Manual". File 
names cannot have blanks in them, or any punctuation characters except the ones just mentioned. 
A file name must not have more than 39 characters; most people don't notice this restriction. 

4.1 Naming convention.'! 

It is importaiit to name your files in some systematic way, using the extension to tell what kind of 
file it is, and the main name to identify it. For instance, useful extensions might be Memo, Letter, 
Note, iMgure, Calendar. If you are a secretary keeping material for several people on one disk, you 
can stick the person's initials in front of the extension, e.g. BWI.memo, JGMmemo etc. If you 
don't have anything specific in mind, it is customary to make the extension the same as the name of 
the program that creates the file, e.g., Rcport.bravo for a document tliat doesn't have any special 
properties, and is written using Bravo. 

Here is a modest list of extensions commonly encountered on Non-programmers' disks: 
.al Alto display-format font file 

.boot A file that can be booted from 

.bravo Bravo-format text file 

.cm Command file for the Executive or other programs 

.image Runnablc Mesa program (subsystem) 

.press Press-fomiat file (suitable for printing) 

.run Runnable Ikpl program (subsystem) 

An Executive command that is executed directly by the Executive (there is no actual 

file corresponding to this naine) 

The Alto doesn't care whether you capitalize letters in file names or not (i.e., ALPHA and alpha 
and aLpHa refer to the same file), but it is a good idea to use capitalization to make names more 
readable. This is especially useful when a name consists of more than one word, since blanks arc 
not allowed in file names: e.g., TripReport or MasterList. 

4.2 File name patterns 

The Executive provides some sitnple facilities for handling files. First of all, it allows you to name 
a group of files by using file name patterns containing the inagic characters "*" and "#". The ""*" 
character stands fi)r any string of characters, bor example, the pattern "*.mcmo" stands for all the 
files which have the extension' "memo", and the pattern "*.BWL*" stands for all the files which 
have BWL as the first three characters of the extension. The "#" stands for any single character; 
for instance, "#^##.mcrao" stands for all the files which have a three character main name and 
the extension "memo", if you arc curious to see what a pattern expands into, you can type X^ immediately after 
typing it to get it expanded. 

If you type a file name or a pattern to the Hxecutive, and then type a tab, it will give you a list of 
all the files whose names start with that name. So, for example, typing 

>*.BWLtab 
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will get you a list of all files which have an extension starting with the characters BWL. 

Another useful thing to know is this: if you arc in the process of typing a file name to the 
Executive, and you type esc, it will add as many characters as it can to complete a file name. If 
you type "?", it will give you a list of all the files which start with what you have already typed; 
you can then go on and finish the file name. 

Here is a sumnidry of magic characters for getting file names expanded: 

ESC completes the file name if possible; if not, completes as much as it can, and flashes the 
screen. 

TAB shows you all the file names which match what you have typed since the last blank, and 
erases what you typed. 

? like TAB, but doesn't erase anything. 



^c 



retypes the command line with all file name patterns replaced by the list of file names they 
expand to. 



There are two more simple commands for dealing with files. To delete a file, or a group of files, 
type 

> Dclete fitel nie2 ...CR 

Warning: once you have deleted a file, you cannot get it back. Proceed with caution, if you have 
enabled version numbers and there is more dian one version of a file, the one with the lowest version number gets 
deleted. 

To get the contents of a text file printed on the screen, type 

>Type fileCBi 

If the contents won't fit on the display, the Alto will show you as much as will fit, then ask if you 
want to see more. If you do, just type a space; if you want to stop, type No. 

When the Executive is running, it displays two lines of status information near the top of the 
screen. Included in this information is the amount of space which is left for storing files. This 
space is measured in disk pages; it takes about 5 disk pages to store one page of text. It is prudent 
to keep at least 150 disk pages available; if your disk has fewer, you should delete some files, 
perhaps after sending them to a file server (see section 6). 



At this point you know enough to use Bravo to begin creating and editing text. Bravo 
is described in its own manual, which is part of the Alto User's Handbook. You should 
start reading the Bravo manual, and not try to continue with this guide until you have 
become familiar with the material in the first two sections of the Bravo manual. The 
remainder of this guide contains more information about the Alto which you won't need 
on the first day, but will probably want in the first week. 

Because much of our day-to-day communication takes place by means of our Alto- 
based electronic mail system, you should also start learning to use Laurel. Begin by 
reading the first two sections of the Laurel manual, which is also pari of the Alto 
User's Handbook. 
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5. Recovering from disasters 

There are various ways in which your Alto disk can become damaged. If tiiis docs happen, the 
procedures described in this section will almost always allow you to recover the disk, or at worst 
will let you copy files from the sick disk to a healthy one. It is probably a good idea to get some 
help with this if you are not experienced. 

Here are the symptoms of trouble: 

You can't boot the disk and get to the Executive. 

You are out of disk space, but you think you should have plenty; in other words, some disk 
space has apparently gotten lost. 

You get an error message from some service which says something about disk errors or file 
errors, and perhaps recommends that you should run the Scavenger. 

You hear a ftmny buzzing noise fi-om the disk for a couple of seconds, after which the 
service you are using breaks in some way. 

It may be that the problem is caused by an incompatibility between the disk drive on which your disk pack wp-: written, 
and the disk drive on which you are trying to use it. This is a likely cause of your problems only if you have been 
moving the pack from one machine to another, and if you notice that it works properly on some machines but not on 
others. If your problem is caused by disk incompatibility, the procedures described below won't do you much good. 
Instead, you should report the problem to the hardware maintenance staff, so that the offending disk drive can be 
realigned, and make yourself a new disk pack on a machine known to be in alignment. You can transfer files from the 
old pack to the new one using the procedure described in section 6.5. 

The first step is to run a program called Scavenger. If your disk is healthy enough to let you boot 
and use the Executive, you can just invoke the Scavenger by typing 

> ScavengerCR 
If it isn't, you should use the NetExec to invoke Scavenger, as described in section 3.4. 

If that doesn't work, hold down just the nS key and press the boot button; this should give you tlie dancing white 
square of the memory diagnostic. If it doesn't, cither your Alto's Hthernet connection is broken, or the boot server that 
provides Alto programs over the Ethernet is down or unavailable. Either find another Alto without these problems, or 
load in a disk which is still in good shape and has the Scavenger program on it, invoke the Scavenger, and then unload 
the good disk and load your sick one. 

The Scavenger will ask you whether you want to change disks, and give you a chance to do so if 
you say Yes. Then it will ask you if it can alter your disk to correct errors; say Yes. 

The Scavenger will now work for about a minute. As it nins, it may ask you whether it is OK to 
correct "read errors". If they are "transient" errors, answer Yes fearlessly; if they arc "permanent" 
errors, it is best to ask for advice from an expert. When the Scavenger is done, it will tell you what 
it found, If it has succeeded in making your disk healthy, you can go about your work. Delete the 
files Garbages and Scavenger! ,og which the Scavenger leaves around. It is a good idea to go 
through this scavenging procedure once a month or so, just to keep your disk in good shape. 

If things arc still in bad shape (i.e., you can't boot and run the Executive), the next step is to boot the NclExcc agiiin 
and type 

> NcwOSCR 
'Ihis should get you a fresh copy of the operating system, which will ask you whether you want to Install. You should 
say Yes, and go through the Install procedure described in section 2. If al| goes well, you will then fmd yourself talking 
to the Executive and can proceed normally. 

If this doesn't work, there is one more step to try. Boot the NetExec again and this time type 

> i'rpcR 

'Hiis should get you the FI'P iMogram described in section 6.3; use it to transfer the files <Alto>I':xcciitivc.run and 
<Allo>Sysr"ont.al from a file server (Maxc or 11^). Then boot the Scavenger as described above and run it ag.iin. If 
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this fails, you siiould consult an expert. If no expert is available, you can boot FIT again, and use it to Uansfcr files 
from your brolcen disk to a file server or to a clean disk on another Alto (made using the procedure described in section 

Ilie Scavenger leaves all the stuff which it wasn't able to put into a recognizable file on a file called Garbage.S. and it 
leaves a readable record of everything it did on another file called Scavengerl^g (unles.s it tells you that you have a 
beautiful disk). There are two kinds of entries in ScavcngerLog: names of files removed from the directory or otherwise 
modified, and names of file pages which were put into Garbage.S. 

5.1 Reporting problems 

If your Alto itself is broken, obtain a trouble report form, fill it out, and leave it in the proper 
place; procedures for doing this depend on your location. 

If you have trouble with Bravo, report it using the procedure in section 4.3 of the Bravo manual. If 
you have trouble with Laurel, sec section 4 of the Laurel manual. 

For other probicins, consult your local expert. 
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6. File servers 

Many uses of the Alto require you to communicate with a shared file server, which can store files 
belonging to a number of different users. A file sci"vcr's disk typically has hundreds of times the 
capacity of your own Alto disk. Moving non-current files to a file server is a way to free up space 
on your own disk for other things, and a file server is a good place to put documents you want 
other people to be able to get at. 

Each organization typically has at least one file server of its own. To make any use of your 
organization's file server, you must first obtain an account and password; to do this, consult your 
local support staff. Your account name will usually be your own last name, and your password 
should be six or more characters long and unpronounceable. 

There are presently two types of file server. Ins and Maxc. An IFS (which stands for interim File System, 
as improved facilities arc under development) is an Alto with somc large disks attached to it and dedicated 
to the one task of being a file server. Many Ip"Ss exist at present. Maxc is a large, general-purpose 
time-sharing system, only one of whose purposes is to be a file server. I'here are only two Maxc 
systems (called Maxcl and Maxc2), both of which belong to Pare. 

[f you are at Pare, you shoiild obtain accounts both on Ivy (the name of Parc's IFS) and on Maxc. 
If you are outside Pare, you will need an account on your organization's own IFS, and you will have 
to find out its name. At present, many users outside Pare are also assigned accounts on Maxc because the Laurel 
message system uses Maxc as a central post-office, and you have to have a Maxc account in order to keep a mailbox 
there. This state of affairs is likely to change in the near future. 

While Ifs and Maxc are fundamentally different sorts of machines, in their capacities as file servers 
they are substantially the same. We shall first describe the facilities common to the two types of 
systems. Later sections will deal with additional facilities unique to one or the other. 

6.1 Logging in 

Before trying to access a file server from your Alto, you should first tell the Alto your account name 
and password. If you have given your account name to Install as the owner name for your disk, 
however, the Alto already knows it, and if you used your file server password as your disk 
password, it knows that too and you can skip to section 6.2. Otherwise, you can give the necessary 
information by typing to the Executive: 

>LoginCR 

You will now be asked for your name and password. Type in each one in turn, ending each with a 
CR or space. Note tliat it assumes your file server account name is the same as your disk owner 
name; if this is the case, you can just type CR to confirm it, and go on to give your password. If it 
isn't, type Diit,, and then give the account name you want to use. Once you have done this Login, 
your Alto will automatically identify you to file servers whenever necessary. If you boot your Alto, 
it will forget this information, and you must Login again. 

Note that Login only records your name and password; it docs not connect you to a file server. If 
you don't do a Login, programs that access file servers will automatically ask you for the Login 
information when they first run, and will record it just as Login does. 

If you wish, you can supply a password for your disk when you Institll (see section 2). If you do 
this, you will have to type the password whenever you boot the Alto, but it will be used 
automatically as your file server password, unless you override it with a Login command. The 
password is stored on your disk in encrypted form, so it cannot be stolen by someone who paws 
around on your Alto disk. 
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6.2 About files on IFS and Maxc 

Ifs and Maxc file names look very much like Alto file names, but they have two more parts: a 
directory and a version number. On IFS, the format is 

<directory>name.extensionlversion 

whereas on Maxc the format is 

<directory>name.extension;version 

Each user who has an account on a file server has his own directory, named by his user name. If 
you name a file without specifying the directory, you will refer to your own directory. You can 
reference files in some other directory simply by prefixing the directory name to the file name, as 
illustrated. 

When you put a file onto a file server, if there is already a file with the same name, the new file is 
added, with a version number one bigger than the old one. When you reference a file, you get the 
one with tlie largest version number if you don't specify which one. As you can see, it is almost 
never necessary for you to specify a version number explicitly. 

There is a protection system, not described here, which allows you to control which other users can read r write your 
files. The usual setting of the protection, and the one you will get automatically if you don't say anything special, allows 
all Xerox users to read the file, but prevents anyone except the owner from writing it. 

On IFS, but not on Maxc, files within a directory may be organized into sub-directories. For example, the file named 

<Joncs>Meinos>ActivityReport.bravo!3 

belongs in directory Jones, sub-directory Memos. You can have as many sub-directories as you wish within your own 
directory. You can even have sub-directories wiUiin sub-directories, to as many levels as you wish, subject to an overall 
limit of 99 characters in each file name. 

Most commands that accept a remote file name also permit you to type a file name pattern, much as 
does the Alto Hxccutive (section 4.2). In this case, the command is repeated for all files that match 
die pattern. If the file server is an Ifs, the magic character "*" (but not "#") may appear 
anywhere in the name, just as on die Alto; if the file server is Maxc, however, "*" must appear in 
place of an entire field of the file name (directory, main name, extension, or version), and other 
uses of "*" are not permitted. Thus, "*.mcmo" and "<Jones>*.*" arc legal file name patterns on 
both Maxc and II-^, but "*.BWL*" is legal only on IfS. Note that to refer to all versions of each file you 
must specify "•" for the version field explicitly (that is, "!•" on IFS and ";*" on Maxc); olherwi.se, the pattern will 
match only one version (usually the highest-numbered). 

6.3 Transferring files 

You can transfer files between your Alto and a file server using Ftp, the File Transfer Program. 
This program has a fairly elaborate set of features, which are described fully in the Prp Reference 
Manual found near the end of the Alto User's Handbook. This section tells you enough about Ftp 
to take care of most ordinary needs. After you have become familiar with this material, you might 
skim over the Ftp manual once, just so that you are aware of the other facilities that are available. 

After starting FlP, you will see tliree windows on the screen; from top to bottom, they are the 
server window, the maw window, and the Chat window. Most interactions with Fr? involve only tlie 
middle window — note the blinking vertical bar tliere, which shows where you can type. The fii-st 
step is to type the name of the machine you want to talk to. For example, if your file server is 
named Ivy, you should just type 

'*IvyCR 

In a second or two you should get back a response like 

Ivy (Pare) file server 1.16 9-Apr-78 
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If the flic server is not operating, there will be delay of about a minute before FfP gives up trying to contact it; you 
can give up sooner by strilcing the blank key to the right of CR. 

Now you can retrieve a file from the file server, or store a file into it. To retrieve, you type 

* Ret rieve remote file Example as local file Example [New file] CR 
As in the Executive, you can just type enough of the command to identify it uniquely, and then a 
space; unlike the Executive, Ftp supplies the rest of the command name automatically. You then 
type the remote file name, followed by a space. If the file server has a file by that name on your 
directory. Ftp will then suggest a local name for the file followed by "[Old file]" or "[New file]", 
depending on whether or not the file already exists on your Alto disk. Tf you like the name, you 
can just type CR. Otherwise, you can type some other name, as in the following example: 

* Rct rieve remote file Example as local file Dummy [New file] CR 
Note that the name originally suggested by Ftp will disappear as soon as you start to type the new 
one. if you decide you don't want to retrieve the file after all, strike del to cancel tlie command. 

After you type the terminating CR, Ftp will transfer a copy of the file from the file server to your 
Alto disk. During the transfer, the cursor will flip its two black squares back and forth every time 
it transfers a block of tlic file, so you can tell how fast it is progressing from the frequency of flips. 
When I'TP is done, it will tell you how long the file is, followed by "Done" and the "*" prompt, if 
you gave a file name paiiern for the remote file, FTP will repeat the above procedure for each file that matches the 
pattern. You may strike DFX to skip over any files that you don't want to retrieve. 

To store a file presently on your Alto disk onto the remote machine, you type 

*St ore local file Example as remote file ExampleCR 
or *St ore local file Example as remote file DummyCR 

again depending on whether or not you want to use a different name. In this case, the message 
"[Old file]" or "[New file]" will not appear; remember, however, diat storing a file on a file server 
ordinarily creates a new version rather than overwriting an existing file with the same name. The 
Store command does not accept file name patterns. 

If you were not logged in at the time you started FlP, you will be asked for your user name and 
password when you do the first Retrieve or Store. Fi'P will save this information so that you won't 
have to provide it again until the next time you boot the Alto. 

You can do as many Retrieve and Store commands as you want. When you arc done, type 

*0 uit 
and you will be back talking to the Executive. 

If you intend to do a lot of transfers to or from a directory other than your own, you can say 

* Dir ectory OtherPirCR 
to make <OtherDir> be the default directory for remote file names; this saves typing <OtherDir> in 
front of each name. Similarly, if you want to refer repeatedly to a sub-direclory on an IFS file server, you can say, 
for example. 

* Dir e ctory Jones>McmosCR 

Directory protections arc ordinarily such that you cannot store into directories other than your own. However, if you 
know the password of some directory, you can conned to it by saying 

* Con nect to directory OthcrPir Password xxxxxCR 
which not only dircct.s FI'P's attention to that directoiy (just as docs the Directory command) but also gives you complete 
access to it, as if you were ius owner. The password is not displayed when you type it, of course. File servers generally 
have many so-called fiks^only directories that don't belong to any particular person but rather are for use by a group or 
pioject. The Connect command is the way you gain access to such a directory, particularly when you want to store files 
into it. 
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6.4 Listing and deleting Jiles 

You can get a list of the remote files that match a file name pattern with the List command; for 
example, 

* List *.bravoCR 

or * List <Joncs>Mcmos>*CR 

It is quite slow, however, and there is no way to interrupt it except to shift-swat out of Ftp. You 
are better advised to obtain such information using the Chat program, to be described shortly. 

To delete a remote file, type, for example, 

* Del etc ExamplcGR 

After displaying the full name of the file, Prp will ask you to confirm or cancel your intentions. If 
there are multiple versions of the same file, the lowest-numbered version will be deleted. 

6.5 Transferring files lo and from another Alto 

In addition to accessing a file server. Ftp can communicate with any other Alto that is also ainning 
l^P. By this means," you can transfer files directly from one Alto disk to another. 

To do tliis, boot the disk and start up Ftp on the second Alto. Suppose its name is Banjo. If you 
. don't know what its name is, you can use its network address, which Ftp shows at the very top of 
the screen (e.g., "3#326#"). Now go to the first Alto, start up Ftp, and tell it to connect to the 
second Alto simply by typing its name (much as you would type the name of a file server); for 
example, 

* BanioCR 

or *3#326^^CR 

Now you may retrieve and store files as usual. Of course, in this case remote file names will not 
contain directories or versions (unless version numbering is enabled on the other Alto). Also, file name 
patterns will not be accepted in any context. 

When you start ITP on an Alto, it is normally ready to act as a remote machine or server as just discussed. If you 
don't say anything special, it will allow any other machine to retrieve files, and to store new files, but not to overwrite 
existing files. You can change these defaults by starting F'TP with 

> Ftp/jc 

where x can be: ^^3: ("" sever) to prevent any such transfers: Protected to allow retrieving only, but no writing: 
Overwrite to allow existing files lo be overwritten. Any server activity is reported in the server window at the top of Uic 
screen. 

6.6 Access via Chat 

The File Transfer Protocol (the means by which FlP communicates with a file server) limits itself to 
the basic set of operations already described. There is an escape mechanism that lets you get at 
some important additional file server facilities directly, using a program called Chat. Chat uses the 
Alto display to simulate a traditional, "dumb" computer terminal, and thereby enables you to talk 
directly to Executive programs running in the file server machines themselves. 

Maxc, being a general-purpose time-sharing system, has a large array of commands and programs; 
only the ones directly concerned with Maxc's role as a file server arc described here (a few 
additional facilities are presented in section 6.8). The Il'S Kxccutive's command repertoire is limited 
to operations on files. Most of the commands described here are the same on Ii'S and Maxc; 
however, tlicre arc a few differences which you should note carefully if you use both systems. 
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To initiate a conversation with the Executive in a file server named, say, Ivy, just type 

> Chat IvyCR 

If all goes well, you will sec the message "Connected to:" followed by some numbers at the top of 
tlie screen, a message from the server's Executive immediately below that, and "@" at the left 
margin prompting you for type-in. If Chat has trouble getting connected, it will tell you its 
problem after trying for a few seconds. This usually means that the server is broken; you might try 
again in a few minutes. 

1'he next step involves logging into the server Executive. Chat may do this for you automatically, 
depending on the version of Chat you are using and the file server you are accessing, in this case, if 
you have lorgotten to l,ogin to your Atto, Chat will first ask you for your account name and password. Otherwise, 
you must type 

©Login (user) name (password) passwordCR 

When the server types more than a screenful at you, it will pause after every scrccnfiil and "ring the 
bell", which causes Chat to display a large ding at the top of the screen. After you have had a 
chance to read the screen, striking any key on the keyboard will get the server to produce the next 
screenful. if you type ahead, tliis feature is suppressed. 

Whatever the server F-xccutive is doing, you can force it to stop by typing C^. On Maxc, you may have 
to type C*^ several times in quick succession to get ' it to stop. 

When you are finished talking to the server Executive, type 

@LogoutCR 

(or "Quit" if the server is an lis). This will terminate your Chat session and return control to your 
own Alto's Executive, if you are connected to Maxc, Chat won't terminate until about two minutes after you log 
out; to give control back to the Alto Executive immediately, type SHIFI'-SWAT. 

If the file server is an Irs, you will be logged out automatically if you don't type anything for two 
minutes. This is because Ii'S can service only a small number of users (currently five) at once; the 
automatic logout is intended to prevent IFS from being tied up by users who aren't doing anything 
useful. 

Chat keeps a record of your conversation on a file called Chat.scratchScript. You can read it with Bravo after a Chat 
session, just to see what happened, or perhaps to copy things out of it into other files, print it, or whatever. There are 
two funny things about this file which you need to know about: 

'I"hc file is not erased when you start a new conversation. Instead, the typescript of the new conversation starts 
at the beginning of the file and continues for as long as the conversation lasted. The end of the conversation is 
marked by the characters <=> after which you may see the remnants of previous conversation.s. 

The typescript file is only 20,000 characters long. If your conversation is longer than that, the typescript will 
wrap around to the beginning. It is possible to make the file larger by editing Uic [CHAT] section of the user 
profile (the file Uscr.cm) in the obvious way. 

You can also initiate a Chat-like convci'salion with a file server while you are running FIT. At the bottom of FCP's 
screen is a "Chat window" (actually labelled "User Telnet"), In which you can talk directly with a file server's Ivxeculivc 
in much Ihc same nianncr as you do with Chat. You can move Ihe blinking cuisor down iiilo the Chat window by 
striking the unmarked key to Ihe right of rIght-SIIll'r; to get back to the middle window, strike the unmarked key to 
the right of RI'TURN. In (he Chat window, after typing the server name followed by CR, you can log in and do 
whatever you want. This window isn't very large and doesn't offer all the conveniences of Chat itself, but at limes it is 
nice to be able to switch very quickly between transferring files and giving commands to the server Executive. You can 
make tlie Chat window larger when you sUirt up FYP by typing FfPZ-S , which prevents the FfP server from being 
started and thereby eliminates ' the upper (server) window. 
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6.7 Server Executive commands 

You type commands to 1f"S and to Maxc in more-or-lcss the same way (except for tliosc commands 
that have different names on the two systems); however, the responses from IFS and Maxc arc 
usually somewhat different. 'I'hc examples below illustrate iFS's responses. You may type "?" at 
any point to obtain a brief explanation of what you are expected to type in next. Maxc normally does 
not display the remainder of abbreviated commands or the explanatory text in parentheses; however, you can force it to 
do so by terminating fields yoii type in with IvSC rather than space. 

To generate a list of the names of all your files, type 

on IFS: @ ListCR on Maxc: @ DirCR 

To list only those files matching some file name pattern, say, "Activity.*", type 

on IFS: @ List (files) Activity.*CR on Maxc: @ Dir Activity.*CR 

To list another user's directory, type 

on lis: @ List (files) <OtherUser>*CR on Maxc: @ Dir <OlherUser>*.*CR 

Caution: note carefully that the command names are different on IFS and Maxc. Worse, there is 
also a l.ist command on Maxc, but with an entirely different meaning (it causes hardcopy to be 
generateay. Be careful! 

You can obtain more detailed information about your files (length, date written, etc.,) by typing a 
comma immediately before tlie CR; for example, 

on IFS: @ List (files) Activity.*,CR on Maxc: @ Dir Activity.*,CR 

At this point, the server Executive will type "@@" at the left margin and pcnnit you to type in one 
or inore sub-commands that modify the action of the main command; in the case of List and Dir, 
subcommands are used to specify what information you wish to see about the files. Some of these 
are: 

@ @TypeCR file type and byte size 

@@ SizeCR size in pages 

@@ LcngthCR length in bytes 

@@ CrcationCR date of file creation 

@@ WriteCR date on which the file was last written 

@@ ReadCR date on which the file was last read 

STImesCR times as well as dates 



@ @AuthorCR name of user who created the file 

@ @VerboseCR same as Type Size Write Read Author 

@@ BverythinfiCR everything known about the file 

After you have typed in one or more sub-commands, type just CR in response to the "@ 
prompt. The server will now perform the main command and list out tlie files with the information 
you requested. The columns of printout will be aligned correctly only if the font Chat is using is a fixed-width font, 
such as Gachal2 or GachalO. 

You can delete one or several files (or all files matching some file name pattern), just as on the 
Alto, with 

@ Dc]cte filel rtle2 ... CR 

On li'S, the server f executive will now print out each file name and ask you to confirm your 
intention to delete it (type Yes or No); this is because once a file is deleted it is gone forever. On 
Maxc, ail the files are deleted immediately without further confirmation; however, there is an 
Undelete command that you can use immediately afterward if you change your mind. 
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To delete all old versions of files (i.e., all but the highest- numbered version of each file), type 
on IFS: © Delete *,CR (note the comma) 

@@ Kcep ICR 

@@CR 
on Maxc: @ DelvercR 

Delete oldest? YesCR 

Delete 2nd newest? YesCR 

Fi1e(s): CR 
It is a good idea to do this fairly frequently, since old versions of files can pile up and waste a lot 
of space. 

To find out how much space you are using on the file server, type 
© DskStatCR 

One li'S or Maxc page is equivalent to about four Alto pages. You will notice that you also have a 
disk limit which is the maximum number of pages you are permitted to use on the file server at one 
time. If you exceed your disk limit, the server won't let you store any more files until you first 
delete some existing ones to get you below your disk limit. To get your limit changed, consult your 
local support staff. 

You can direct your attention to some other directory by typing 

© Connect (to directory) OtherPir (password) passwordcw 

just as in Pit. You may omit the password when connecting back to your own directory, or when connecting to a 
directory belonging to a project of which you are a member. 

For tlie sake of security, it is a good idea to change your password occasionally (say, once a year), 
lo do this, type 

© Change Password (of directory) name (old password) xxx (new password) yyycv. 

where name is your account name. The new password should be six or more characters long and 
unpronounceable (tliis is not enforced, however). Note that, contrary to normal practice, the new 
password does print out when you type it; this is so that if you make a typing mistake you will be 
able to see it. 



6.8 About Maxc 

Maxc's Hxecutive is thoroughly documented in its own manual, which was written primarily for 
programmers and contains a large amount of infonnation not needed by casual users of Maxc. 
The next few paragraphs document Maxc facilities likely to be of interest to Alto non-programmers. 
If you don't use Maxc you may skip this section. 

If you have a file on Maxc in Press format (see section 7.1 for an explanation of file formats), you 
can tell Maxc to print it directly by issuing the "Press" command. 'Ihis is documented in section 
7.5. 

Maxc provides facilities for archiving files onto magnetic tape, where the cost of storing them is 
negligible. You can get an archived file back within one day. 

To archive one or several files, type 

© Archive File fdel fdel ...CR 

(Note that the command name consists of the two words "Archive File"; after that you should type 
tlic names of the files you want to archive.) The files will be archived onto tape within a day or 
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two. After this has been done, they will be deleted from the disk automatically, and you will get a 
message notifying you that the archiving has been done. 

Maxc keeps track of your archived files in an archive directory which you cari list exactly like your 
regular Maxc directory, using the Interrogate command rather than the Directory command; for 
example, 

© Interrogate *.bravoCR 

If the listing is of just one file, Maxc will ask you whether or not you want it retrieved from the 
tape. If you say Yes, the file will appear on your Maxc directory within a day, and you will get a 
message to that effect. Il .should be noted thai the Iiiterroeate command has some peculiarities not shared by other 
commands; in particular, you sometimes have to type an extra CR at the end of the command in order to get it to do 
anything. 

Ikcause Maxc's disk capacity is fairly small relative to the number of users who have Maxc 
accounts, the disk occasionally becomes full and it becomes necessary for a forced archive to be 
performed in order to make some space available. In a forced archive, all files that haven't been 
referenced (retrieved, printed, or whatever) in the past 90 days arc written onto tape and deleted. 
You will be notified when any of your files arc archived for this reason, and the procedure for 
getting them back is the same as given above. 
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7. Printing 

'nie subject of printing is somewhat complicated because of the large number of variables involved. 
To begin with, there are many different programs that you can use to prepare documents for 
printing — Bravo, Draw, Maricup, Sil, etc. Then there arc various file formats defining the 
representation of documents stored in files — Bravo-format, Press-format, plain text, etc. Finally, 
there arc several different types of printers— Dosqv, Sequoia, Slot/3100, Pimlico, etc. 

This section first presents some introductory information on programs, file formats, and printers, 
i'ollowing that are a few of the most common procedures for printing documents. 

7.1 Programs and file formats 

Each of the programs you can use to prepare documents deals with information in a particular 
format. Bravo deals with text interspersed with special information about looks (fonts, paragraphs, 
etc.), and document files written by Bravo's Put command are in Bravo format, which only Bravo 
can read. The same can be said about Draw, Sil, and a number of other programs. 

In order to t)C printed, a document generally has to be in Press format, which is a file format 
designed principally for representing printed pages. It follows that to print a document that is in 
some other format you must first convert it to Press format. 

Programs that have their own special document formats also provide facilities for generating 
documents in Press format. For example, when you are using Bravo and you issue the Hardcopy 
command. Bravo first converts the document you are working on into Press format (this is. why 
Hardcopy takes so long), then sends the resulting Press file to a printer. By using the File option of 
tlic Hardcopy command, you can tell Bravo to write the Press file on your disk rather than sending 
it to a printer. 

The important point is this: a given document can be represented in several different formats. 
When you issue tlie Put command in Bravo you store the current document as a Bravo-format file, 
but when you issue the Hardcopy command with tlie File option you store the same document as a 
i'rcss-format file. But while these arc two different representations of the same document, only the 
Bravo-format file can be read back into Bravo (using the Get command), and only the Press-format 
flic can be sent to a printer. You can't read a Press file back into Bravo. This is why it is 
important to choose file names in such a way as to identify their formats— the extension .Bravo to 
identify Bravo-format files, .Press for Press-format. .Draw for Draw-format, etc. 

'i'hcre are a few programs that deal exclusively with Press files. Markup is an illustrator that can 
both read and write Press files. PressEdit is a program used to manipulate Press files in various 
ways, such as combining several small Press files to create a single large Press-format document. 

7.2 Printing servers 

To print a document you send it through the network to a printing server, which is an Alto 
connected (usually) to some Xerographic printing device. The means by which you do this depend 
both on what kind of document you have and what type of printing server you are sending it to. 

There is a bewildering array of names you will hear associated with printing servers. These names 
fall into three categories.. There are family names that identify the type of printing device attached 
to the server Alto— a Dover is based on a Xerox 7000 copier, a Sequoia on a 3100, a Pimlico on a 
6500, etc. Then there arc names for different types of printing software used on the server Alto to 
control the printing device — Spruce and Press arc the principal ones in use at present. Finally there 
are names identifying individual printing servers— the names by which you specify which particular 
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server is to print your documents. Examples of names of printing servers in Palo Alto are Clover, 
Menlo, Daisy, and I'urkey. 

To complicate matters further, while every printing server accepts Press files to print, there are 
different kinds of Press files and not all printers are capable of printing every kind of Press file. A 
Press file can contain a mde variety of information: text, straight lines, smooth curves, raster- 
scanned images, and even color. Obviously, if you send a Press file containing color to a black-and- 
white printing server you will not obtain the results you might desire; but tliere are other 
restrictions as well, most arising from technical considerations that will not be discussed here. As a 
rule, however, most printing servers will attempt to print any Press file as best they can and will tell 
you about whatever difficulties they may have encountered. 

Here are some brief descriptions of the types of printing servers presently in use. 

Dover is the predominant work-horse printer. It is based on a Xerox 7000 copier and is capable of 
continuous high-volume output (one page per second). It is best at printing documents consisting 
primarily of text, though it has limited capabilities for printing simple illustrations such as those 
produced by Sil. More complicated graphics (e.g., curves produced by Draw or raster-scanned 
images produced by Markup) can only be printed crudely if at all. Also, Dover prints pictures 
containing large solid black areas very poorly. 

Sequoia is a smaller and slower printer, based on a Xerox 3100 copier. It can print more complex 
pictures tlian can Dover, and it prints solid black areas very well. 

Pimlico is a Xerox 6500-based color printer. TC-200 is based on a Xerox Telecopier. Versatec is an 
electrostatic printer, some models of which can print on vei-y large sheets of paper. Slot/3100 is 
similar to Sequoia. All these printers are capable of printing any kind of Press file (with the 
exception, of course, that color information is ignored by black-and-white printers). 

Certain Press files contain copies of graphical information in two or more alternate forms. For example, cui-vcd lines 
produced by Draw arc represented in the Press file both by mathematical descriptions and by Alto screen-resolution bit 
mai)s. Printing servers that understand the niatliematical descriptions will use tlicm to produce smooth curves, whereas 
servers ihat don't understand the matliemalical descriptions— principally Dover and Sequoia— will print the bit maps 
instead, producing rather crude curves. 

7.3 Fonts 

There is a large array of fonts available for printing text. All fonts are named according to a 
standard convention: 

family- name point-size face 

The family-name describes the overall style of the font; e.g., TimesRoman or Helvetica. The point- 
size specifies tlie height of the font in points (one point is 1/72 inch). The face, if present, describes 
one or more additional properties of the font: B for bold, L for light, I for italic, C for condensed, 
and li for expanded, for example, HelveticaiOB is a font in the Helvetica family, 10 points high, 
bold-face; TimesRoman 12ni is TimesRoman, 12 points high, bold-face, italic. 

A Press file containing text includes the names of the fonts to be used to print the text, but does not 
include any information about what the characters actually look like. Rather, each printing server 
maintains the printing representation of the set of fonts used most commonly by users of that 
printer. Many servers have a limit on the number of different fonts they can keep (related to the 
size of the disk attached to the server Alto). If you try to print a Press file containing text in a font 
the printing server doesn't know about, the server will substitute some other font and will tell you 
about this. 

Programs such as Bravo that format text according to how wide the individual characters are obtain 
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the necessary information from a standard widths file named Fonts.widths, which must be present 
on your Alto disk. Additionally, in order to display text on the Alto screen you must have the 
appropriate screen fonts contained in files named font-name.a\. You can usually obtain these files 
from the <Altol'onts> directory in your file server. See section 4.6 of the Bravo manual for further 
information on how Bravo deals with fonts. 

Here are a few fonts that most printing servers know about. There are samples of some of them at 
the end of the Bravo manual. 



Family 


Poini-sizes 


Faces (as 


TimesRoman 


8, 10, 12 


B, I, BI 


Helvetica 


7, 8, 10. 12 


B, I. BI 




6. 18 


B 


Gacha 


8, 10. 12 


I 


Cream 


10, 12 


B, I, BI 


Math 


8, 10 




Hippo 


8. 10 




Arrows 


10 





You should consult your support staff to find out what fonts are available on your local printing 
servers. 

7J Printing from your Alto 

After you first initialize your disk and before you attempt to print anything, you must edit your 
user profile (file User.cm) to declare the name of the printing server you intend to use regularly. 
Sec section 2.4 of the Bravo manual. All programs except Laurel that generate hardcopy look in 
User.cm to find out where to send Press files to be printed. For Laurel, you must also edit your 
Laurel profile, file Laurel.profile, described in section 3.6 of the Laurel manual. 

Generating hardcopy directly from Bravo is easy: you just issue Bravo's Hardcopy command, 
described in section 2.4 of the Bravo manual. If instead of just printing hardcopy you wish to 
distribute a document on-line (say, by storing it on a file server so as to make it available to other 
Alto users), then rather than distributing die Bravo-format document you should make a Press- 
foi-mat file and distribute that. To do tliis, use the File option of the Hardcopy command and 
specify a file name with extension .Press. 

Once you have a Press file on your disk (having eidier created it yourself or retrieved it from a file 
server), you can send it to your printing server using the Empress program. If you just type 

> Rmprcss filenameCR 
one copy of die document will be printed by your default printing server. If you want more copies 
or you want to print on a different printing server, you can use the /C and /H switches; for 
example, 

> Hmprcss 3/C Menlo/H filenameCR 
will cause three copies of die document to be printed by the printing server named Menlo. 

To print a file that is in some odier format, say Draw or Sil, you must first create a Press-format 
version of that file. The means by which you do this arc described in the appropriate manual, i.e., 
in the Draw manual for Draw-format files, the Sil manual for Sil-format files, etc. Once you have a 
Press file you can print it using Empress as just explained. 

There is an additional file format called plain-text. Basically it is a text file containing no font 
information and no formatting. You can create a plain-text file using Bravo if you start with an 
empty window and never type any ctrl-crs or looks, but do type ordinary CRs at the ends of lines. 
A non-programmer is unlikely to encounter plain-text files very often; but, for example, User.cm, 
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l.aiirel.profilc, and Executive command files (see section 8.2) are plain-text files, as are 
documentation files with extension .tty that you obtain from a file server (section 9.2). 

You can print a plain-text file using Bravo Hardcopy, but there is an easier and much faster way: 
just type 

>Em press filenameCK 

[impress will discover that the file is plain-text rather than in Press format, and will convert it into 
Press format before transmitting it to the printing server. Emprcs.s will normally use a single font, GachaS, 
for this purpose. You can change this to something else by editing the [HARDCOPY] secUon of User.cm to include a 
line such as 

FONT: TimesRoman 10 B 

The foregoing procedures for sending Press files to printing servers apply to those printers that run in server mode, i.e., 
that wait for someone to send (hem a Press file over the network and automatically print any files they receive. There 
arc some printers that do not operate in server mode, usually because they cannot safely be left to run unattended. To 
print a document on one of these printers, you have to go to that printer's Alto, use FfP to retrieve the Press file you 
want to print, and type 

> Press Print fi/enameCR 

'llicre are sometimes additional operating procedures which you will find posted near the printer. 

7.5 Printing from Maxc 

If you want to print a Press document or a plain-text file that is stored on Maxc, you can retrieve it 
to your Alto using FlP and send it to your printing server using Empress, as already explained. 
However, you can alternatively tell Maxc to send the file directly to the printer. 

Before you do this, you must tell Maxc the name of your printing server. You do this by creating 
(with Bravo) a plain-text file containing the single statement 

PDEVlCE servei^^ 

where server is the name of your printing server. Then Put onto file DocGcn.prt, Quit, and use Ftp 
to transfer DocGen.prt to your directory on Maxc. 

Whenever you want to print a document that is stored on Maxc, you should connect to Maxc's 
server Executive using Chat and issue the command 

@ Press filcnameCR 

where filename is the name of a Press-format file (extension .press) or a plain-text file (e.g., 
extension .tty). You cannot use the Press command to print other kinds of files— in particular. 
Bravo-format files. 

If your DocGcn.prt file on Maxc also contains the line 
REPORT Y^"^ 

then Maxc will attempt to notify you as soon as it has actually sent the file to the printer. Maxc will display a message 
on your screen if you are slill connected to Maxc's .server Executive at the lime; otherwise, it will send you a message 
that you will receive next time you nm Laurel. 

7.6 PressEdil 

You can compose the various parts of a document with Bravo, Markup, Dnm, Sil, or other 
programs that produce Press files, and then put together the complete document with a program 
called PrcssEdit. You can also use PressEdit to extract pages from an existing Press file. PressEdit 
has some other features, some of which are documented here and the remaining ones in the Alto 
Subsystems manual. 
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The use of PressHdit for assembling dociimeiits has one major advantage: the resulting complete 
document can be left on a file server for printing by anyone who needs a copy. If you are 
producing a document for large-scale printing outside, on the other hand, it is probably easier to 
assemble it by hand than to go through all this ritual. One restriction you should be aware of is 
that every printing server has a limit on the size of Press file that it can handle (this is principally a 
function of the capacity of the disk connected to the server Alto). Most printing servers can handle 
Press files up to about 50 pages long (printed pages, not Alto disk pages), though some can handle 
documents substarjtially larger tlian that. If you have a very large document, you should distribute 
it as several Press files, each containing no more than 50 pages. 

The simplest use of PressRdit is to append together two or more smaller Press files to create a single 
large one. For example, 

> PrcssBdit Manual.prcss *- Chaptcrl.press Chapter2.press Chapter3.pressc :R 

creates Manual.prcss by concatenating the three other Press files in the order given. Be sure to type 
a space both before and after the "♦-". You should also remember that the new Press file will 
occupy as much disk space as the three existing Press files combined; check that you have enough 
free disk pages before you start. 

You can copy selected pages out of a Press file and put them into a new Press file by a command 
such as 

> PressRdit Short.press ♦- Long.press 3 6 10 to 14 18 to 22CR 

This extracts pages 3, 6, 10 through 14, and 18 through 22 from Long.press and puts them in 
Short.press. Note that the numbers refer to consecutive pages in the source Press file, counting from 1, and have 
nothing to do with any page numbers that actually appear on the pages themselves. 

The concatenate and extract operations may be combined in one command to produce a document 
with pages from two or more source documents interleaved. This is particularly useful for inserting 
illustration pages into text documents. I'or example, 

> Prcsspdit Report-press <- Tcxt.press 1 to 3 Figures.press 1 Text.press 4 to 8 Figures.press 2 
1 ex t. press 9 to 14CR 

This produces a document consisting of pages 1 through 14 of Text.press, with page 1 of 
Figures.press inserted between pages 3 and 4 of Text.press and page 2 of Figures.press between 
pages 8 and 9. 

If you want to make a document that has pages containing both text and illustrations, tlierc are two 
ways to merge selected pages of different Press files. Both techniques are unfortunately ratlier 
cumbersome. The first method involves interleaving the pages of the text and illustration Press 
files, as just described, and then using Markup to copy material from one page to another in the 
resulting file. This procedure is documented in section 4 of the Markup manual. It is very slow 
and requires a lot of manual labor, and it does not always work for illustrations produced by any 
program besides Markup. 

The second technique requires you first to put special marks in tlie text and illustration Press files 
to show how you want tiic illustrations to be positioned. You then run PressHdit, which merges the 
source Press files automatically to produce the desired document. 

I'xxh illustration must be conttiincd in a separate, one-page Press file. Somewhere in the illustration 
must appear an "arrow" consisting of the following piece of text: 

There should be no spaces or oUier characters either before or within this piece of text; you must 
position the arrow using the text positioning facilities of the illustrator you arc using. 
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The main text document must also contain an arrow to show the position of every illustration. 
Inside each arrow must appear the name of the Press file tliat contains the illustration to be inserted 
tliere; for example, 

<= =<Fig3.press< 

Again, there must be no spaces or other characters either before or within the arrow; you must 
position it by setting the left margin appropriately and possibly by using the vertical tab 
feature — see sections 3.2 and 3.6 of the Bravo manual. 

Having prepared all the Press files, you merge them by typing a command of the form 

>PrcssRdit/M Documcnt.press *■ Text.press Figl.press Fig2.press Fig3.pres8CR 

After the "*•" you must type the name of the main text file followed by the names of all the 
illustration files you are inserting into the final document. You may list the illustration files in any 
order, and if you are inserting a particular illustration into more than one place in the final 
document, you need type its name only once. 

Now, each time PrcssEdit encounters an arrow in tlie text document, it merges into that page "the 
illustration contained in the Press file whose name is inside the arrow. PressRdit positions the 
illustration on the page by aligning the two arrows, then removes the arrows. 

PressRdit also has a facility for adding fonts to Press files. This is useful primarily when you want 
to edit the Press file with Markup and add text in some font that does not already appear in the 
file. For example, to add fonts Logo24 and Helvetical2 to file Example.press, type 

>PrcssRdit Rxamplc.press <- Rxample.press Logo24/F Helvctical2/FCR 

The next time you read Rxample.press into Markup, the new fonts will appear in Markup's font 
menu in addition to the ones that were there before. 



8. Other things 

This section describes various facilities and procedures that you will probably find useful at some 
point. Browse through tlicm now just so you know where to find them. 

S.I Copy and Rename 

To copy one file to another, say 

> Copy new <- olclCR don't leave out the spaces 

The "*-" is to remind you of tlie direction the copying is done. 

To change the name of a file, say 

> Renamc new *■ oldCR don't leave out the spaces 

or: > Rcnamc old newCR 

'["here must not already be a file called new. However, if old and new differ only in capitalization. Rename may 
be used to change the capitalization. 
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8.2 Command files 

If you have a sequence of Rxecutivc commands tJiat you wish to execute repeatedly, you may put 
them into a command file, then invoke the command file at any later time. To create a command 
file, use Bravo to enter the exact commands that you would issue to tlie Executive, then Put the 
document onto a file witii the extension ".cm", the standard extension for command files. 

To execute a command file named, say, Cleanup.cm, type 

> @Cleanup@CR 

The Executive will display the first command in the command file, perform the command, and then 
go on to the next command, continuing until it has executed all the commands in the file. To abort 

execution of a command file, type C*^, which will stop it at the end of the current command, or SHIFT-SWAT, which 
will stop it immediately. 

Actually, you may substitute the contents of a command file for any part of an Executive command 
line. For example, if file ListOfl^-ilcs.cm consists entirely of the text "Alpha Beta Gamma Delta" 
(with no CR at tlie end), and you type 

>l)c]r' te @ListOfFilcs@ EpsilonCR 

the effect will be exactly the same as if you had typed 

> Dcletc Alpha Ik ta Gam ma Delta EpsilonCR 

A number of commonly-used programs, most notably Ftp, are capable of accepting their own 
commands from the Executive command line used to invoke them. Normally, when you start up 
f-'TP simply by typing 

> FtpCR 

F^rp then expects you to type commands to its own keyboard command interpreter. But if you start 
it up with, say, 

> Ftp Ivy Storc/C Memol.bravo Rcport2.pres sCR 

I-Yp will make a connection to the Ivy file server, store the files Memol.bravo and Report2.press on 
your Ivy directory, and return control to the Executive, with no further action on your part, except to 
type in your password if you haven't already logged in. 

This capability may be used in conjunction with command files to permit you to deal with large 
groups of files all at once. For example, if you have a set of Bravo documents comprising one large 
report, you can create a command file, say, Rcport.cm, containing the names of those files, then 
issue the command 

> Ftp Ivy Store/C @Report.cm@CR 

to transfer a complete, consistent set of diose files to a file server. 

You should be aware that the language used to control F^rp from the command line is not the same 
as that used to control it from the keyboard, though it is similar. You should read section 4 of the 
Ftp manual before attempting to create Ftp command lines. 

8.3 Dump files 

The Executive's Dump command gives you a way to package up a number of files into a single, so- 
called dump file. You can then transport the dump file aroimd as a unit, and later recover one, a 
few, or all of the files from it using the Load command. This is especially useful in maintaining 
consistent sets of related files. 
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To make a dump file, type 

> Dump Alpha.dm filel file2 ... CR 

Here "Alpha.dm" is the name of the dump file; by convention it has the extension "dm." You can 
list as many files as you want to be dumped. Often the * feature of the Executive is usefijl here, 
and of course you may obtain the list of files from a command file. 

To get files '■■ack from a dump file, type 

> Load/v Alpha.dmcR 

You will get a list of the files in Alpha.dm, and after each one you will be asked whether you want 
it loaded or not. If you leave out the /v all the files which don't already exist will be loaded; if you 
say /c instead, all the files will be loaded whether or not they are already on your disk. 

'llie Ftp program has facilities for accessing dump files on a file server: you may transport a 
collection of files on your disk to or from a remote dump file without ever having to put the dump 
file on your disk. That is, the command 

>Ftp Ivy Dump/C Alpha.dm filel file2 ... CR 

will package together ri\es file f,file2, etc., and store them as Alpha.dm in (he file server, not on your 
Alto disk. Similarly, 

>Ftp Ivy Load/C Alpha.dmCR 

will access Alpha.dm on Ivy and load the constituent files onto your Alto disk. You will probably 
find that this is more convenient than using the Executive's Dump and Load commands. See 
sections 3 and 4 of the Ftp manual for complete information. 

8.4 Neptune and Dds 

The Neptune program provides convenient facilities for managing files on your Alto disk. Basically, 
it displays the names of all the files on your disk in a window that you can scroll just as in Bravo, 
and it permits you to specify operations on individual files simply by pointing at their names with 
the cursor. It can delete files, display the contents of text files, and (if your Alto has two disk 
drives) copy files from one disk to another. 

The Neptune manual is included at die end of the Alto User's Handbook. If you read sections 1 
through 4 of that manual you will know enough to start using Neptune. 

There is another program called Dds which is considerably more powerftil than Neptune and 
provides a number of useful capabilities that Neptune lacks. However, it is rather slow and takes 
up a great deal of space on your disk, so it is not included on the Basic Non-programmers 
Disk. You should try it out and see whether its features are valuable to you. The Di:)S manual 
appears as part of the Alto Subsystems manual (see section 9.2). 

8.5 Illustrators 

There ai"e currendy three major programs . for drawing pictures on the Alto: 

Markup: good for pictures involving images, free-hand drawing or painting. Markup is 
also useful for adding pictures to a text document produced by Bravo; these 
pictures can come from Draw or Sil, or they can be drawn by Markup itself. 

Draw: good for pictures which contain lines, curves and text. 
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Sil: good for foims and pictures with only horizontal and vertical lines. For such 

pictures it is much faster than either Markup or Draw. 

Manuals for Markup and Draw arc included in later sections of the Alto User's Handbook. Sil is 
also suitable for general use; unfortunately, the present Sil documentation is rather terse and is 
oriented principally toward users of the Design Automation system, of which Sil is a part. You can 
obtain this documentation, such as it is, by printing <Sil>SilManual.prcss. 

8.6 CopyDisk 

The simplest use of the CopyDisk program is copying the contents of one disk pack to another on 
an Alto equipped with two disk drives; it was described in section 2. CopyDislc can also copy the 
contents of a disk pack from one Alto to another over the Ethernet. To use it in this mode, you 
need two Altos; in the example below they are called Banjo and Flash. 

Put thie disk you want to copy from into one Alto (say, Banjo), and use the NetExec to invoke. 
CopyDisk (see section 3.4). Put the disk you want to write onto into the other Alto (Flash), and 
start CopyDisk on that Alto also. You will type all commands on Flash, i.e., the Alto containing 
the disk you want" to write onto. 

You should now go dirough tlie following dialogue: 

* Copy from: [Banjoll^POCR the digit zero, not the letter O 

Copy to: DPOCR 

Copying onto DPO will destroy its old contents. 

Are you sure this is what you want to do? [Confirm] Yes 

Are you still sure? [Confirm] Yes 

In the above example, in response to "Copy from:" you type the name of the other Alto (the one 
you are copying from) in square brackets, followed immediately by "DPO" (with no intervening 
spaces). If you don't know the name • of that Alto, you can instead type its Ethernet address 
(displayed in die black bar on that Alto's screen) followed by a #. In response to "Copy to:" you 
type simply "DPO", meaning the disk pack in drive of the Alto on whose keyboard you arc 
typing. 

After you have confirmed your intentions, the copy should proceed. When CopyDisk is done, if all 
went well you will sec the message "Done. [Banjo]DPO and DPO are identical" followed by the "*" 
prompt. You may now type QuitCR to each Alto, 

8.7 Version numbers 

There is an optional version number facility that permits you to keep multiple versions of a 
particular file on your Alto disk without having to invent a different name for each one. This can 
be particularly valuable when you are making a number of successive changes to a document but 
want to keep earlier versions around in case you change your mind. Files stored on file servers 
always have version numbers, but use of version numbers on Alto disks is optional. 

Unfortunately, die version number capability has not been ■integrated fully into all Alto programs 
(in particular, the Eaurcl message system). Furthermore, the relatively small amount of storage 
available on an Alto disk makes wholesale maintenance of iiiiiUi[»'e versions impractical. For these 
reasons, the version number facility is disabled on the Basic Non-programmer'S Disk. If you 
wish to use it, you may enable it by doing an Install, asking ''or ^It • "long installation dialogue", and 
answering the questions appropriately. 
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[f the version number facility is enabled, a file name may end with an exclamation point followed 
by a number: for example, "Alto.Manual!4" is version 4 of the file Alto.Manual. The basic rule for 
version numbers is this: 

When you read a file, you get the one witli the largest version number (the current version) 
unless you include the version number you want in the file name. 

When you write onto a tile for which the current version is n, a new version n+l is created 
and becomes the current version, unless you include the version number in the file nan-' 
hurthcrmore. if version n-\ was around, it gets deleted, so that just two versions of the fi"le 
arc kept, the current one (widi the largest version number) and the next earlier version The 
number of versions kept may be changed at Install time. 

For example if version 4 is the current version of the file Alto.Manual, there will probably be 
Alto.Manual!4 and ■Alto.Manual!3" around. If you write onto "Alto.Manual" (e.g. by doing a 
Put from Bravo), AltoManual!3" will disappear, and "AIto.Manual!5" will appear with the new 
information on it "Alto.Maiuial!4" will still be around unchanged, so you can get die old version 
back from there if you need it. On the other hand, if you write onto "Alto.Manual !4". that file will 
be changed, and no new versions will be created. 

If a file name doesn't have a version number, most programs will not make any new versions but 
will just write on the single version. Bravo is an exception; it always makes new versions if the 
version number facility is enabled. 



9. Software distribution and documentation 

Alto software and documentation are publicly available from file servers. Most file servers maintain 
duplicate copies of common files. In Palo Alto, most software and documentation of interest to 
non-programiners is stored on Maxc; in other places, on the local Ifs. You should consult your 
support suirt tor the exact maintenance policies used in your organization. 

9.1 Obtaining new software releases 

When new versions of the various programs are released, they are normally announced by messages 
to all registered Alto users. You can obtain a new version of a service called, say. Alpha as follows: 

If the release announcement includes instmctions for installing the new version of the 
program, follow those instrucdons. Otherwise: 

Using Pip, attempt to retrieve <Alto>Alpha.cm from your file server. If tliis succeeds leave 
Frp and type to the Executive 

> @Alpha.cm@CR 

This will cause Prp to be invoked again, some files to be transferred from your file server 
and perhaps some other activity. When everything settles down, you will have the new 
vereion. 

If there is no <AIto>Alpha.cm, retrieve <Alto>Alpha.run. This will be the new version of the 
program. You don't have to do anything else. 

It is a good idea to keep fairly up-to-date. New versions of programs arc sometimes released to fix 
serious bugs or to refiect important changes in operating procedures. If you run into trouble while 
running an obsolete version of some program, you are unlikely to receive much help or sympathy 
from the programs maintamer or from your local support group ' h jr 
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The best way to obtain a complete sot of new software, and clean up your disk at the same time, is 
to obtain a fresh disk, initialize it from the Basic Non-programmi^R'S Disk as described in section 
2, and then use Pl'P to transfer all the files you want, to keep from your old disk to the new one, as 
described in section 6.5. if you have an Alto with two disk drives, you can put the old disk in one drive and the 
new one in the other, then use Neptune to copy files between disks. See sections 1 through 4 of the Neptune manual. 

An alternative way to make a Basic Non-programmer'S Disk is to put the disk you want to 
initialize into an Alto, boot die NetExec as described in section 3.4, then type 

> NewOSCR 

You will get a fresh version of the operating system, which will ask you if you want to Install. Say 
Yes, ask for tlie "long installation dialogue", and say that you want to erase a disk. After a minute 
or so, you will have a clean disk with nothing on it except the Executive and Ftp. Use Pit to 
retrieve die file <Alto>NewNpDisk.cm from your file server. I'hen type 

> @lSewNpDiskCR 
This will automatically transfer all the needed files from the file server, and do any other necessary 
initialization. It takes about 20 minutes, and puts a significant load on the file server, so use diis 
procedure only when you can't find the Basic Non-programmrrs Disk. During die operation, 
there will be an automatic Install of the operating svstcm; answer its questions appropriately. You 
will have to type your name and password at various points in the procedure. There will also be an 
automatic initializatit)n of Bravo, and you should do a Quit when it is finished. 



9.2 Documentation 

Documentation for all the standard Alto software can be found in the <AltoDocs> directory on 
Maxc and other file servers. As a rule, each major piece of documentation appears as a Press file 
which you can obtain and print by means of the procedures explained previously (section 7). Short 
documents arc available as files with die extension "tty"; these are plain text files that you can 
tiansibr to your Alto and read with Bravo or print wiUi Empress. 

To sec what is. available, you can Chat to your file server and type 
on IFS: ©List <AltoDocs>*.press <AltoDocs>*.tty 

on Maxc: @Dir <AltolOocs>*.press <AltoDocs>*.tty 

Here is a short guide to on-line documentation likely to be of interest to non-programmers but not 
already contained in the Alto User's Handbook. All arc stored on die <AUoDocs> directory except 
where noted otherwise. 

Alto Subsystems, files Subsystemsl.press and Subsystems2.press. 

This manual, which is about 150 pages long, contains documentation for a large number of 
Alto programs. Included is comprehensive information on Chat, CopyDisk, Empress, and 
the Executive, which are only partially described in the Alto User's Handbook. An 
additional program of interest to non-programmers is Dos, which enables you to display and 
manage your Alto disk's file directory in ways much superior to Neptune. 

Aho Subsystems Catalog, files SubsystemsCatalog.press. 

This is a summary of Alto subsystems, organized by flmction. 

Sil, Analyze, Gobble, Build Reference Manual, file <Sil>SilManual.press. 

Sil is an illustrator specialized for very rapid composition and editing of pictures consisting of 
straight lines and text. It is part of the Design Automation system for digital logic 
development, but Sil is useful in its own right as a general- purpose illustrator. 
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Printing at Palo Alto, file Printing.press. 

This is a comprehensive summary of Press printing facilities, formats, and programs. Despite 
its title, it is applicable more-or-less everywhere. 

How to Use IFS, file <IFS>HowToUse.press. 

This is a complete user's manual for Irs, presenting a fair amount of material not covered in 
the Alto User's Handbook. 

The Alto User's Primer, file AltoUsersPrimer .press. 

This document contains some introductory material on Alto hardvi^are and software. It is 
oriented towards newcomers to the Whole Alto World, and its main purpose is to describe 
what exists and how to get it. 

Whole Alto World Newsletter. 

This is a monthly newsletter that serves as a vehicle for communication of Alto-rclated 
information among Alto users throughout Xerox. Each mondi's edition is stored as 
WAWNcwsm-;'>'.prcss; for example, WAWNews8-78.press is the August 1978 edition. 
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Preface 



'llils manual describes the Bravo system for creating, reading and clianging text documents on the 
Alto, it is supposed to be readable by people who do not have previous experience with computers. 
You should read the first four sections of the Non-Programmers Guide to the Alto before starting 
to read this manual. 

You will find tliat things are a lot clearer (I hope) if you try to learn by doing. Try out the tilings 
described here as you read. 

Material in small type. like this, deals with fine points and may be skipped on first, or even second, reading. 

This manual is written on the assumption that you have the user profile, fonts and other Bravo- 
relatcd material from tlie Basic Non-programmer'S Disk. If this is not the case, some of the 
diings which depend on that stuff will not work tlic same way. 

There is a one-page summary of Bravo at the end of this manual. It is intended as a memory- 
jogger, not as a complete specification of how all the commands work. 

Bravo wtts designed by Butler Lampson and Charles Simonyi, and implemented mainly by Tom 
Malloy, with substantial contributions from Carol Hankins, Greg Kusnick, Kate Rosenbloom and 
Bob Shur. 
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1. Introduction 

Bravo is the standard, Alto system for creating, editing and printing documents containing text. Tt 
can handle formatted text, but it doesn't know how to handle pictures or drawings; for these you 
should use Draw, Markup or Sil. 

When you start up Bravo (do it now, by saying Bravo/eCR to the Executive), you will see two 
windows on the screen, separated by a heavy horizontal bar. The top one contains three lines with 
some useful introductory information; it is called the system window. The bottom one contains a 
copy of the material you are reading, which was put there because of the "/e" you typed to the 
Executive. If you had omitted the "/e", as you do when using Bravo normally, the bottom window 
would be empty, except for a single triangular cndntark which indicates the end of a document. In 
the bar separating the two windows is the name of the document in the lower window. 

As you do things in Bravo, the first two lines of the system window will give you various useful 
pieces of information which may help you to understand what is going on and to decide what you 
should do next. Usually, the top line tells you what you can do next, and the second line tells you 
what you just did, and whether anything went wrong in doing it. Utake a habit of looking at these 
two lines while you are learning Bravo, and whenever you are unsure of what is happening. 

No matter what is going on in Bravo, you can stop it and get back to a neutral state by hitting the 
Di'l, key. You can leave Bravo and get back to the Executive by typing 

Qi'itCR 

The characters which you type (Q and CR) are underlined in this example; the characters which arc 
not underlined are typed by Bravo. This convention is used throughout the manual. Notice that 
you only type tlie fiist character of the Quit command; this is tme for all the Bravo commands. 

i;ach Bravo window (except the top one) contains a document which you can read and change. 
Usually you read the document from a file when you start Bravo, and write it back onto a file after 
you have finished changing it. Later, you will find out how to do this (section 2.3). It is possible to 
have several windows, each containing a document; this too is explained later on (section 4.2). 

Bravo is controlled partly from the keyboard and partly from the mouse, the small white object with 
three black buttons which sits to the right of the keyboard. As you push the mouse around on your 
working surface, a cursor moves around on the screen. Pushing the mouse to the left moves the 
cursor to the left, pushing the mouse up (away from you) moves the cursor up; and so forth. You 
should practice moving the mouse around so that the cursor moves to various parts of the screen. 

The three buttons on the mouse are called RED (the top or left-most one, depending on what kind 
of mouse you have), yei,i,ow (tlie middle one) and blue (the bottom or right-most one). I'hcy 
have different functions depending on where the cursor is on the screen and what shape it has. 
Don't push any buttons yet. 

Mouse lore: 

You will find that the mouse works better if you hold it so that it bears some of the weight 
of your hand. 

If the cursor doesn't move smoothly when the mouse is moving, try turning the mouse 
upside down and spinning the ball in the middle with your finger until the cursor does move 
smootl\ly as the ball moves. If this doesn't help, your mouse is broken; get it fixed. 

You can pick the mouse up and move it over on your work surface if you find that it isn't 
positioned conveniently. For instance, if you find the mouse running into the keyboard 
when you try to move the cursor to the left edge of the screen, just pick die mouse up and 
set it down further to the right. 
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2. Basic features 

This section describes the minimum set of things you have to know in order to do any useful work 
with Bravo. When you have finished this section, you can read the other parts of the manual as 
you need the information. 

2.1 Moving around in a document 

Move the cursor to the left edge of the screen and a little bit below die heavy black bar. Notice 
that it appears as a double-headed arrow. It will keep this shape as long as you stay near the left 
edge, in a region called the scroll bar. If you move it too far right, the shape will change. Keep 
the cursor in the scroll bar for the moment. 

Now push down the REiD (top or left) button and hold it down. Notice that the cursor changes to a 
heavy upward arrow. This indicates diat when you let the button go, the line opposite the cursor 
will be moved to the top of the window. Try it. This is called scrolling the document up. 

Next push down the blur (bottom or right) button and hold it down. Now the arrow points down, 
indicating that when you let the button go, the top line on the screen will be moved down to where 
the cursor is. Try it. This operation takes a few seconds, so don't get impatient. Practice scrolling 
the document up and down until you feel comfortable with it. It is useful to know that if you don't 
move the mouse, scrolling with red and RLUE are symmetrical operations: one reverses the effect of 
the other. 

You may have noticed that the text on the screen doesn't fill up the window, but that more text 
appears when you scroll up. The reason for tliis is that in addition to space on die screen, Bravo 
needs space inside itself (in die Alto's memory) to display lines of text on the screen. When a line 
has only a few characters, it doesn't take up much internal space, but when it runs all the way 
across the page, like the lines in diis document, it takes a lot of internal space. When Bravo runs 
out of internal space, it stops displaying text and leaves the rest of the window blank. You can tell 
that there is more text in the document (i.e., that you aren't seeing the end), because when Bravo 
gets to the end it displays a triangular endmark as the very last thing to mark die end. If you don't 
see the cndniark at the bottom of the displayed text, you can be sure that there is more text in the 
document which isn't being displayed. 

If you keep the cursor in the scroll bar, near the left edge, and hold down yiiLLOW (the middle 
mouse button), you will see die cursor change into a striped right-pointing arrowhead. Think of it 
as a thumb, and the entire left edge of the window as the pages of a closed book, corresponding to 
your whole document {not just to what is displayed). If you stick the thumbnail into the book and 
flip it open, you will find yourself someplace in the book. If the thumb is near the middle, you will 
be about in the middle. If it is all the way at die top, you will be at die beginning; if all the way at 
the bottom, you will be at the end. 

The tip of the arrowhead acts like the thumbnail, and letting go of yei,i,ow is like flipping open the 
book. You will also sec another striped arrow, enclosed in a box. This one is called the bookmark; 
it points to your current location in the document. After you let up YIM^LOW, if you hold it down 
again wiUiout moving the mouse, die thumbnail and the bookmark should coincide cxacdy, making 
a solid arrowhead; this happens because the thumbing operation moved the document exactly to the 
place indicated by the thumbnail. To move forward a little, push the thumbnail down a litde below 
die bookmark and thunib again; to move back, push the thumbnail up a little above the bookmark. 
To get to the beginning, push die thumbnail up until the arrowhead overlaps shghdy the horizontal 
bar at the top of the window. Try thumbing your way through die document until you feel 
comfortable with it. Also try thumbing and then scrolling up and dowii. 
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2.2 Changing (he text 

In order to make a change in the text of your document, you have to: 
say where you want tlic change made, by making a selection; 
say what you want done, by giving a command 
You always make the selection first, then give the command. If you change your mind about where 
you want the change made, you can always make another selection. Making a selection is just Hke 
pointing with a pencil: it doesn't have any effect on the document. Only commands can change the 
document. You never have to worry about getting rid of a selection, since it never does any harm. 
If you make a selection, and then give a command that doesn't require any selection, that is 
perfectly all right; the needless selection will be ignored. 

You make selections by pointing with the mouse and pushing one of the buttons. To try this out, 
move the cursor into the region of the screen where the text of the document is displayed. Notice 
tliat the cursor is displayed as an arrow which points up and slightly to the left. Point the arrow at 
a character (any character) in the document, and click red. The character you pointed at should be 
underlined; if it is, you have just selected it. if it isn't, look nearby and see if some other character is 
underlined. If you find one, then that is the one Bravo tliought you were pointing at. Experiment until you feel 
confident that you can point easily at characters. 

You should note that each selection erases the previous one; there is only one selection at a time, 
and it is the most recent one. Also, you can make a selection at any time, except when you are in 
tlie middle of a command. Once you have started a command, you must either finish it normally, 
or abort it by striking del, before you can make another selection. 

Something useful to know: if you hold red down, you can move the cursor around and tlie 
selection will follow it. The selection won't freeze until you release red (or move die cursor out of 
tlie text area). Try this too. 

Now try a selection using yellow instead of red. Notice that instead of underlining a character. 
Bravo now underlines a whole word. A word is defined as consecutive letters and digits, or 
consecutive punctuation characters. Eor convenience, apostrophe is counted as a letter. Also, a number containing 
a decimal point is a single word. 

There is one more thing to learn about selecting text: how to select more than one character or one 
word. To do this, first select a character with RED. Then point to another character and click 
blue; Bravo will underline all the characters between the one you selected with red and the one 
you pointed at with blue. This is called extending the selection. Try holding down BLUE and 
moving the cursor around. The selection will change continuously so that it includes the characters 
between the one you originally selected with red and the one you are pointing at now. As before, 
when you let up tlie button, the selection will freeze. You can change the extension as many times 
as you want by using blue: over and over; Bravo will remember the original selection you made 
witli RI'D until you make another one. 

Finally, try selecting a word with yellow and then using blue to extend the selection. Notice that 
the end of the selection will be a word also. To select the entire document, issue the Everything 
command. 

Space, TAB a,nd carriage return (cr) characters in the document simply appear as white space on the 
screen, just as they do on paper. You can, however, select them like any other characters. Try iL 
You will notice that not all the white space on tlie screen can be selected; in fact, the space on a 
line after a CR, and the space to the left of the left margin, cannot be selected. Bravo's handling of 
white space is discussed in detail in section 3,5. 
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Now that you know how to say where you want a change made, it's time to malce a change. Select 
something (for instance, a word). Now type D (for Delete). The word you selected \% deleted from 
the document, and the selection moves over to die character after the original selection. The rest of 
the text is adjusted to malcc up for the deleted material; if necessary some words may be brought 
up from the next line to fill up the one which contained the deleted material. 

You can undo the deletion by typing U (for undo). Try it; you will see the stuff you deleted 
reappear, and ii. will be selected again, just as it was before you deleted it. Do several deletions, 
followed by undos, until you are sure you know what will happen. Try deleting larger pieces of 
text by extending your selections. Be sure not to move the selection between doing the Delete and 
the Undo. 

Delete and Undo are commands. Like all Bravo commands, they arc given by typing just the first 
letter of the command name. You can type the letter in either upper or lower case. 

To add new text, select something in front of which you want the new text to go (if you want it to 
go at the very end of the document, you can select the cndmark). Then type I (for Insert). You 
will sec that a blinking caret appears just before the selection. This marks the place where the new 
text will go. Anything you type will appear where the caret is, and as you type each character, the 
caret will move over to make room for it. Try typing a few characters, and notice that the rest of 
die text is automatically rearranged to make room for the new stuff. 

If you strike the wrong key while typing, you can erase the mistake by striking the us key (on the 

. right side of the keyboard). You can erase as many typed characters as you like using bs. You can 

also use A*^ (hold down the CTRI- key and type A) to erase a character; it works just like BS. and may be more 

convenient to type with your left hand, if your right hand is on the mouse. To erase typing on a larger scale, 

you can use W*^ (hold down the CTRL key and type W) to erase a word and its following spaces or 
punctuation characters. When you have typed as much as you care to, hit RSC to finish the insert. 
Notice that the caret disappears, and that the inserted material is selected. You can undo the 
insertion with Undo. Then you can undo die undo and get the insertion back. Try it. 

Sometimes it is more convenient to insert after a selection, radier than before. You can do this with 
the Append command (remember that you just type the A). Except for where the new material 
goes, Append is exactly like Insert. 

If you want to change one word into another, or correct a typo, you have to delete some text and 
insert other text in its place. This can be done by a Delete followed by an Insert, but it is more 
convenient to use the Replace command, which combines these two functions into one. Replace 
can also be undone. 

Whenever Bravo first displays the blinking caret, you can insert a copy of some existing text rather 
than typing in now text. You do this by making another selection, called a copy selection, instead of 
typing. The copy selection is made exactly like an ordinary selection, and you can even use the 
scroll bar to move around in the document in order to find the text you want to copy. You can 
distinguish a copy selection from an ordinary one by its dotted underline, which contrasts widi the 
solid underline of an ordinary selection. 

You can change your copy selection as many times as you like. When you are satisfied widi it, type 
lisc, and a copy of the copy selection will be inserted in place of the blinking caret. You can't do 
anythuig else while you are making a copy selection, except to scroll the document. 

A copy selecdon can be tised to move text from one place to another: first copy the text, and then 
delete the original. 
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'Inhere is one more uscftil thing to know about insertion. If you just type an F.SC for an insertion, 
without making a copy selection or typing anything else, a copy of the last thing you inserted or 
deleted will be inserted. This is called repeating or defaulting an insertion; it is very convenient for 
inserting the same thing in several places, e.g., a dollar sign in front of several numbers. It also 
gives you anotlier way to move text: first delete it, and then insert it in its new place by selecting 
the new place and typing Insert followed by ESC . 

You now know all three ways of doing an insertion: typing the text, selecting some existing text to 
be copied, or defaulting the previous insertion by simply typing ESC. I'hese three ways of inserting 
text can be used whenever a Hravo command needs some text. You will see many references to 
"inserting text" as you read on. 

llcfore going on to learn anything more about Bravo, you should practice the Delete, Insert, 
Append and Replace commands, and copy selections, until they are quite familiar. 

2.3 Filing a document 

Whetlier you use Bravo simply to read or browse through a document, or to create or change it, 
you will need to fetch the document from a file before starting, and to file it away again aft^;rwards 
if you have changed it. This section tells you how to do these things. 

To fetch a document from a file, give the Get command. You will sec the blinking insertion caret 
appear in the heavy black bar above the window. Insert the text of the file name, usually by typing 
it In, and ending it widi an ESC just as for any other insertion. The document will appear in the 
document window, and there will be a note in the system window telling you how long it is. A Get 
will erase the old contents of tlie window, if any. 

To file a document away, give the Put command, and type the file name as you did for Get. If the 
name you want is already in the black bar, you can just type ESC to default the name. It is also 
possible to edit the file name in the black bar, exactly like an ordinary document. Put always files 
away the entire document, regardless of what the selection is; when it is done, you will see a note 
which tells you how long it is. JJravo turns most of the screen black while executing a Put; tJiis makes the Put 
run faster. Do not be alarmed at this. 

Warning: If you make some changes to your document and then attempt to Quit from Bravo 
without having done a Put, iiravo will warn you diat the document has not been filed and will ask 
you whether you still wish to Quit. If you want to save the document, strike del to cancel the Quit 
command, then file the document using Put. If you want to quit without saving the document, type 
Yes. If you do this, you will lose any changes you have made to the document, if this does happen to 
you, read section 4.3 on replaying to see if you can still be saved. 

If you Get a document from a file and Put it back on the same file. Bravo will save the original on 
a backup file. Normally tlie backup file's name will be the name of the original file followed by a 
"$". I'he backup file is sometimes useful if you discover that some of the changes you made are 
not to your liking after all. if you have enabled version numbers at Install lime (not recommended), the backup 
flic will be the old version of the file from which you did ihc Get, and Hravo will make a new version for the Put (sec 
•section 8.7 of Ihc Alto Non-progranmicr's Guide for a discusision of file versions). 

You can do an "unformaticd Oct" with the z5 command (type Zc instead of Get): this treats the formatting information 
at Ihc end of each paragraph as ordinary text. The main use of Z*^ is for patching up a file which has been damaged by 
hardware failure or cosmic rays. In particular, if Bravo refuses to Get llie file because "End of file not in Bravo 
formal", you can usually correct the pioblem by doing an unformatted Get of the file, deleting the last line or two, and 
Putting it back. Then Quit, restart Bravo and tiy again to Get the file. 
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2.4 Hardcopy 

Printed copies of a document may be obtained using the Hardcopy command. Before using 
Hardcopy for the first time, you must tell Bravo tlic name of the printer you intend to use regularly. 
To do this, Get the file Uscr.cm. In that document, you will find an entry that looks like this: 

[hardcopy] 

preff-rri'dformat: press 
PRESS: Namc-of-your-Press-printer 

Replace the words "Name-of-your-Prcss-printer" with the name of the printer you intend to use 
(every printer has a icgistcred name such as Clover, Menlo, or Daisy). Then Put the document, 
Quit, and type Bravo/iCR to the Alto Executive. 

To print one copy of the document you arc editing, simply give the Hardcopy command followed 
by CR. This will print the entire document, regardless of what the selection is. While doing the 
hardcopy, ikavo displays in the cursor a count (modulo 10) of the number of pages it has 
processed; hardcopy takes about 8 seconds per full page, like this one. After sending the document 
to the printer. Bravo will report success. If there is a problem. Bravo will leave a note in the system 
window. If the printer is not responding. Bravo will leave a note to that effect, and keep trying. 
You can abort the Hardcopy by typing del, as always. 

The hardcopy may fail for several reasons. If there is an EITP error, trying again will usually work. If the problem is 
that there is a character in your document which is in a font for which there is no printable representation, Uravo leaves 
one of the offending chaiactcrs selected, and puts it at the top of the screen. You can try again after modifying the 
looks of the selected character. If you have a page with so many different fonts thai it exceeds the capacity of the 
printer. Bravo leaves the first character of the page selected and at tlie top of the window. There is no remedy for this 
problem except to simplify the offending page. Sec section 4.6 for more information about fonts. 

You may want more than one copy of a document. The Hardcopy command has an option called 
Copies, which allows you to specify the number of copies you want; you type in tlie number, and it 
will appear in the leftmost buffer in the system window, much like a file name. You must give the 
Copies option right after the Hardcopy command, every time you want more than one copy. 

If you compare the hardcopy of your document with Bravo's display, you will see that although the 
text is identical, the hardcopy has more words on each line, so that the two versions look quite 
different. In order to sec a nearly exact facsimile of the hardcopy on the screen, you can give the 
command 

Look hardcopy (note the lower-case h) 

You are now in hardcopy mode on the screen. Until further instructed. Bravo will represent the 
printed version of your document as faithfully as it can, by positioning each character on the screen 
within one-half screen dot (about .007 inches) of its position in the final hardcopy. The screen 
representation is 10% larger than die printed one. To turn off the hardcopy simulation, type 

Look Hardcopy (note the upper-case H) 

You can edit normally in hardcopy mode. In fact, if your document contains tables whose 
appearance is critical to you, it is advisable to stay in this mode, because in tlic normal mode text 
will take up much more space on the screen than it will in the final hardcopy (ir you have such tables, 
you should also read section 3.5 on white space and labs). In hardcopy mode it is also possible to see exactly 
where lines will be broken, so that you can insert hyphens by hand if necessary. 

Bravo provides a number of facilities for controlling page formatting, which you can read about in 
section 3.6. 

The Hardcopy command has options for printing on the Diablo printer, and for producing a Press file which can be 
combined with drawings into a larger printable document, or sent to a file server for public distribution. 'ITicsc arc 
described in section 4.8. 
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2.5 Miscellaneous 

As you edit, Bravo keeps track of the changes you make to the document. In doing this, Bravo 
consumes space in ti\e Alto memory. During a long editing session, it is possible to consume all the 
available space, in which case Bravo will leave a warning note ("Core storage getting low") in the 
system window, and will refuse to execute any more editing commands. If this happens, you should 
Put your document onto a file immediately, and then Quit, restart Bravo, and Get the document 
back from the file. Now you can continue with another editing session. 

When you have finished editing one document and have filed it away, you can Get another file, 
and continue working. It you are making extensive changes, however, it is better to Quit and restart 
Bravo when you start to work on a new document. If you do this, you are less likely to provoke a 
bug in Bravo, and you will be able to recover from a crash with tlie replay feature (section 4.3) 
much more quickly. 

Fhe maximum si/e of a Bravo document is 65,536 characters. Whenever Bravo Gets or Puts a 
document, it leaves a note telling you how long the document was. When your document has 
reached 65,536 characters, you won't be able to add any more text, and peculiar things may occur if 
you do try to add more text. It is a good idea to split the document into two parts well before this 
happens. To encourage you to do this. Bravo will flash the screen and display a warning message after every 
command if die length of llie document exceeds 60,000 characters. 

If you type a character which has no printable representation. Bravo will display it as a black 
rectangle. The best thing to do with such a character is to delete it. 

Depending on exactly what Bravo is doing, the amount of text it can display on the screen will vary. 
You can always get the maximum amount of text displayed by doing a scrolling operation; if you 
scroll up with the cursor at the top of the scroll bar, the text won't move, and Bravo will just 
display as much more as it can. If you then give a command, some of the text may disappear from 
the screen, but you can always get it to reappear by doing another scrolling operation. 

Bravo keeps copies within itself of information in your user profile (file User.cm; see section 4.6) 
and in various files on your disk: font files (named *.al and Fonts. Widths), and the files containing 
the Bravo system and its temporary storage (named Bravo.*). It refreshes these copies whenever 
you start it up with 

> Bravo/iCR 

This is called inilializing Bravo. It is necessary to initialize whenever you get a new version of 
Bravo or the Alto Operating System and when you change your user profile or any font file. 
Initializing is just like starting Bravo up normally, except that it takes about a minute. If you are in 
any doubt about whether something has changed since the last time you iaitialized Bravo, or if your 
Bravo is crashing with messages which refer to disk or file errors, you should initialize Bravo by 
starting it with Bravo/i. 

You now know enough to edit unformatted documents. Take a rest. 
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3. Formatting 

ITiis section describes the Bravo facilities for creating formatted text and pages. It you are not 
interested in formatting, you don't have to read it. If you are interested, be sure to read sections 
3.3 and 3.4, where you will find a lot of good advice. 

Bravo normally describes character sizes and distances on the page in points. A point is a unit of 
distance used in the printing industry; there are 72 pomts per inch. Thus 36 points is 1/2 inch, and 
18 points is 1/4 inch, in many cases, you can also specify distances in inches or centimctei'S, as 
described in section 3.2. 



3.1 Making pretty characters 

Bravo allows you to say how you want your text printed: in italics or bold face, underlined, in 
various sizes and type styles, superscripted or subscripted, etc. You can change the way existing 
text is printed, or you can say how you want the characters to appear as you arc typing them in. 
We will begin by describing how to change the looks of existing text. 

First, select the text you want to mess with. Then give the Look command. Tliis command has a 
large number of options, each specified by a single character, which is sometimes followed by some 
additional information: 

bold SHIFT B to un-bold 

italic sniFr I to un-italicize 

::::. to underline shift - to remove the underline 

jl to subscript (text down 4 pts) Down ESC to remove subscript or 

SHUT *• or t to superscript (up 4 pts) superscript 

to 9 to set the typeface 

visible to display spaces, tabs, and CRS SHIFT V to stop this. 

Down followed by a distance (see below) to _Up followed by a distance to move the 

move the text down that distance, relative to text up. Superscript is Up 4. 

tlie baseline. Subscript is Down 4. 

CLR (the blank key to the right of ns on an Alto-I, or the key labelled BW on an Alto-II) to 
restore the standard looks: font 0; not bold, italic, underlined, visible, graphic, up, or down. 

The typeface is usually called the font. For Bravo, each different size of the same style is a 
different font, but bold and italic arc considered to be in the same font. ITie choice of fonts is 
specified by your user profile in a way which is described later (in section 4.6), but the standard 
choice provided on the basic non-programmer's disk is: 

Times [loman, 10 pt. This is the standard font. 

1 Times Roman, 8 pt. 

2 XKROX logo (only the capital letters E O R and X) 

3 Math, 10 pt. A large set of mathematical symbols. No bold or italics on hardcopy. 

4 Greek, 10 pt. No bold or italics on hardcopy. 

5 Times Roman, 12 pt. 

6 Helvetica, 10 pt. 

7 Helvetica, 8 pt. 

8 Gacha, 10 pt. This is a fixed-pitch font. 
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9 Helvetica, 18 pt. The bold-face version of this font is especially good for making view- 
graphs. 

You will find tables at the end of this manual which give the correspondence between ordinary 
characters and the Math and Greek fonts, and some samples of die various fonts. 

'rhere is another Look option which is very convenient. It is Look Same, followed by a copy 
selccdon. In this case, what is copied is tlie looks, rather than the characters. This is the way to 
get one piece of text to print in the same style as another piece. 

Like most commands, Look can be repeated with ESC. This is uscfiil if you want to change the 
looks of several pieces of text in the same way. You can also undo a Look with Undo. 

You can find out what the looks of a character are by selecting it and giving the Look ? command. 
Bravo will tell you (in the system window) all the looks of tlic selected character. You may have to 
scroll the system window up in order to see all the looks. 

Looks during typing 

When you start typing, the looks which will be attached to the characters you type are set to the 
looks of 

the first character of the selection if die command is Insert or Replace; 

the last character of the selection if the command is Append; 

the standard looks otherwise. 

To change the looks while you are typing text, use the Ctrl key instead of the Look command: 
hold down CTUL and type the look you want. The only things described above which you can't do 
this way arc Look Up and Down; you can get tlie standard superscript and substript offsets with t 
and <-, though. To restore the standard looks, you can just strike the CLR key; it is not necessary to 
use CTRL in this case. 



3.2 Paragraphs 

In addition to changing the looks of the characters, you can also change the shape of the text: the 
margins, space between lines, justification, centering, etc. The Bravo facilities for doing tills are 
based on the idea of a paragraph. 

A paragraph in Bravo is all tlie text between two cfrl-cr characters. You can tell when you have 
one by selecting it. To do this, move the cursor into the line bar, which is between the scroll bar 
on the far loft, and die text area. You can tell diat you are in the line bar, because the cursor will 
appear as a rightward-pointing arrow. Once you are in tlic line bar, use the YtiLLOW button to 
select a paragraph. Note that the cursor changes to a paragraph symbol; it keeps this shape as long 
as the selection is a paragraph. 

'llie CFKL-CR ihal ciid.s a paragraph 'carries the paragraph looks described below. It can also cany character looks, and 
if you are setting up a standard paragraph, it is a good idea to attach to its Cl'RL-CR the cliaracter looks which you 
want as the standard ones for the paragraph. ITius, for example, the CTIU--CR for a standard heading like the one at 
the start of Ihis section would carry the italic look. Of course, this is just a convenience, and not essential; you can 
always set the character looks during typein as described above, e.g. by typing ic for italics. 

If the text at the end of a paragrapfi is in a font smaller than the standard one, as this one is, the CTRL-CR ending the 
paragraph should carry the same font looks. Odicrwisc, the inter-linc spacing of the paragraph may appear uneven. 
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The YF.LLOW button selects exactly one paragraph, so by looking at what is underlined you can tell 
where the paragraph starts and ends. Note that the second ctrl-cr (the one that ends the 
paragraph) is counted as part of the paragraph; the first ctrl-cr is part of the previous paragraph. 
You can use blue to extend the selection to several paragraphs. 

To merge two paragraphs into one, just delete the ctrl-cr that separates them. You will probably 
want to replace it with a couple of spaces, or maybe with an ordinary CR. To break one paragraph 
into two, insert a CTRL-CR; it is just like any other character, except that you can't backspace over it. 

If you select a paragraph and then give an Append, Insert or Replace command, a blank paragraph 
with die same looks as the selected one will be created for you to type into. 

To change the looks of a paragraph, you can use some more sub-cases of the Look command. 
Select the paragraph (or any text in it) first, and then say Look, followed by: 

center; turns off justification shift C to stop centering 

justify (even right margin); turns off centering SHirr J to stop justifying 

nested to indent the whole paragraph (36 pts, shift N to un-indent 

or 1/2 inch, more) 

open up more white space in front of die sillFr O to close up the white space 

paragraph (12 pts, or i/6 inch, more) 

£ to open up half as much more white space in shift to close up the white space 

fiont of the paragraph as Open does (6 pts more) 

All of these can be invoked during type-in; hold down the cirl key and strike the appropriate key, 
just as you do for character looks. 

In the following Look cases, d is a distance on the page, which can be specified in several different 
ways, as described below. Distances are measured from tlie left edge of the paper (except for Up 
and Down, which measure from the baseline of the line of text). These looks cannot be used 
during type-in. 

Left d to set the left margin. The default is 85 points, or about 1.2 inches from the left edge 
of the paper. 

First d to set tlie left margin of the first line. Use this to control indenting or un-indcnting 
of the first line. A Look Left cancels a Look First, since it sets the left margin for all the lines of the 
paragraph. 

Paragraph d to set the left margin of all the lines except the first. A Look U(t cancels a ix)ok 
Paragraph, since it sets the left margin for all the lines of the paragraph. 

Right d to set the right margin. The default is 527 points. Since an 8.5" x 11" page is 612 
points wide, this results in 85 points, or 1.18", of white space on the right. Thus, the default 
margins center the text on the page. 

X n to set tlie space or leading between lines. The leading should be at least 1 point (as it is 
in this document) to avoid a squashed effect. If you want a less dense appearance, try larger 
leadings. The default is 6pt, which gives double spaced text. 

Y n to set the leading in front of the paragraph. The default is 12pt, which gives a blank 
line between paragraphs. Look open increases the paragraph leading by 12 pts, and Look q 
increases it by half that, or 6 pts. On hardcopy, botli line and paragraph leading are 
suppressed for the first line of a page or column. Leading must be less than 64 points. 

Here arc the ways to specify the distance. Try diem out until you arc quite comfortable with them. 
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By typing a number in one of the following forms: 

123 or 123pt a distance in points. A point is a printer's unit equal to 

1/72 of an inch. A number witliout a decimal point and 
with no explicit units is assumed to be in points. 

1.71, 1.71in or 1.71" a distance in inches. A number with a decimal point and 

no explicit units is assumed to be in inches. 

4.34cm a distance in cendmeters. 

a sequence of blanks a distance equal to the width of that many blanks. 

By typing a number «, as above, preceded by + or - . The distance specified by n is added 
to, or subtracted from, the current value of the look being changed. Thus, to indent a 
paragraph by an additional one-half inch, type Look Left +.5 ESC . 

By using Bl,ui! to point to a place on the screen. The horizontal position of the place you 
point at is displayed in the system window. If you hold down BLUE and move around, the 
displayed position is updated continuously. 

By using red to select a character. The horizontal position of the left edge of the char.cter 
is displayed in the system window. 

By typing \ (back-slash, not /), which displays a default value for the look being changed in 
the system window. 

By just typing esc, which uses the value already in the leftmost buffer of the system window. 

You can select, point or default as many times as you want, just as with an ordinary copy selection. 
Then you can type a number, if you like. When the leftmost buffer in tlie system window has the 
value you want, type ESC to complete the cominand. Of course, if you get disgusted you can always 
type DEL to cancel the whole thing. Note that pointing is a convenient way to measure horizontal 
positions on the page. 

Look All, followed by a copy selection, will copy all the paragraph looks of the paragraph in which 
the copy selection is made, to tlie paragraph containing tlie current selection. Note that Look All copies 
paragraph looks whereas \jaoV. Same copies character looks. 

If a paragraph is selected (using YELLOW in the line bar; the cursor will be a paragraph symbol 
when a paragraph is selected), tiie Look ? command will display the paragraph looks in the system 
window; if the selection is not a paragraph, the command displays character looks, as described in 
the previous section. You may have to scroll the system window to see all the information. Note 
tliat it appears in a buffer (sec section 4.5) which is made current, and you can insert it into a document with a default 
insertion. 

If you have a paragraph whose left margin is less ihan the default (normally 85 pts), any characters in the t)aragraph to 
Ihc left of the default margin will fall off the left edge of the whidow and will not be displayed, 'fry setting a Icll 
margin to some values less than 85, and see how this works. You can change the setting of the left edge of the window, 
.so as to make these characlci's visible on the screen, with the command 

Window Edge d rfis a distance, which must be typed in and cannot be obtained by pointing. 

The distance (/ is the distance from the left edge of the page at which the left edge of the window should be .set It 
should be smaller than any paragraph left margin if you want to sec all the characters on the left. L'or instance, if d is 
0, the Vifindow edge will be at the paper edge; if the text has the u.sual 85 pt margin, this will result in 1.2" of white 
space in the window (in addition, of course, to the white space in the line and scroll bars). The default value for d is 
the default left margin. 
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Hints 

You can select several paragraphs (using blue to extend your selection) and apply the same Look 
command to all of them. You can change the looks of every paiagraph in the document by doing 
an Bverytliing to select the whole document before the I^ook. A Look command involving a 
distance of the form +n or -« adds or subtracts « from the look value for each selected 
paragraph. Thus, Look Left ±5 HSC will indent each selected paragraph by five more points. 

If you use several different formats (e.g., for section headings or for indented material) you can 
copy the formatting from an existing example of a particular style to a newly created one with Look 
All. Often it is convenient to put a set of sample paragraphs at the head of your document, each 
containing one line which explains what it is a sample of. Then you can spht the window (as 
described in section 4.2) and have the samples readily available to copy from with Look All. This 
is highly preferable to entering all the new looks manually every time you switch to a new format. 

An alternative technique for creating a new paragraph in a specific style is to select the paragraph 
before or after the point at which the new paragraph is to appear, then Append or Insert and make 
a copy selection of the desired sample paragraph. Now select the text of the newly-created 
paragraph, not including the ctrl-cr at the end, and Replace it with new text that you type in. 
This method copies both character looks and paragraph looks from the sample paragraph. 

When you are setting up the format for a document, you should put a few blank paragraphs (just 
CiRL-CRs) at the end, and set the formatting on all of them to your standard format (it is 
convenient to do this by copying the formatting from a paragraph which already has your standard 
format). ITiis might include indenting the first line of a paragraph, setting the leading, leaving 
space between paragraphs, justification, and even the font. Now when you add material to the 
document by inserting into one of these blank paragraphs, you will automatically pick up all of the 
formatting you have preset. As you type along, each time you use a CTRL-CR to start a new 
paragraph, it will acquire the same formatting as the old one. 

3.3 Formatting style 

This section is intended to provide you with some guidance in using all the different ways Bravo 
gives you for controlling the appearance of your document. Many of the rules arc based on the 
customs of the printing industry. There are two advantages to following these customs: 

they are the result of many years of experimentation, during which many people have tried 

to find out what looks good on the page; 

readers are accustomed to seeing text presented in this style. 

You will notice that some of the niles are contrary to the usual practice for preparing documents on 
a typewriter. There are good reasons for this: when you are printing with variable-pitch fonts, 
italics, boldface, justification, and precisely controlled leading, some of the things which work well 
for fixed-pitch, single-font documents are no longer appropriate. 

Emphasis 

Use italics for emphasis in text. You can also use boldface, but this is usually less desirable, and it 
is better to reserve boldface for words which play some special role, e.g., begin ahd end in computer 
programs. You should also use italics for the names of variables, e.g., "Suppose there arc n items." 

Don't use underlining for emphasis; it is not compatible with tlie use of italics and boldface. Use 
undcrlinmg only when you want a different kind of emphasis, e.g., to distinguish the characters a 
user types from the ones the machine types, as is done in this document. 



Bravo Manual 45 



Don'l capitalize a whole word for emphasis. In fact, try not to capitalize a whole word at all; it 
usually looks terrible in a variable-pitch font because the capital letters are so much wider than the 
small ones. If you have words which you think should be set in capitals for some reason, try 
Small Capitals. In this example, the S and C were 10 point (font 0), the rest of the letters 8 
point (font 1). Compare this with the appearance of FULLY CAPITALIZED words and you will 
see the point. 

Section Headings 

In general, use left-justified rather than centered headings, and don't use all capitals, for the reasons 
just discussed. Here is a satisfactory list of styles for the headings of successively larger portions of 
your document: 

smallest Italic 18 pt paragraph leading (Look Y 18, or Look § if 

your standard leading is 12 pts). 

next Bold 24 pt paragraph leading (Look Y 24, or Look o if 

your standard leading is 12 pts). 

largest 12 pt bold 36 pt paragraph leading (Look Y 36, or Look o 

twice if yoir standard leading is 12 pts). 

Note that you can switch from the standard leading to the 1.5, 2 or 3 times standard leadings for 
headings during typein, using oc and gc. For the largest units, you can center the heading and/or 
use all caps instead of, or as well as, switching to a 12 pt font. It is best not to have more than 
three levels of heading, but you can extend to four or five levels using these tricks. Helvetica 18 
bold (font 9 bold) is sometimes nice for chapter or document titles. 

Use Look Keep 80 (see section 3.6) on headings to make sure that the heading doesn't end up all 
by itself at the bottom of a page. 

Leading 

The standard printing fonts are designed in such a way that they need some extra space between 
the lines to avoid a cramped appearance. You put this space in with I^ok X, and you should use 1 
pt for ordinary single-spaced text. If you want a less dense appearance, experiment with more 
leading. For double-spacing of the text, try Look X 6 (the default). 

Use double spacing (Look o) between paragraphs. When you have indented material which is fairly 
short, try 6 pt leading (Look q), as in the example two paragraphs back. Don't use extra carriage 
returns to get blank space between paragraphs. However, the maximum leading you can specify is 
63 points; if you need more (e.g., to leave space for a figure) you will have to put in blank 

paragraphs. 

Note that both line and paragraph leading are suppressed for the first line of a page or column. The height of a Une of 
text (in points) is equal to the point size of the largest font used in the line, provided there are no characters which have 
been superscripted, subscripted or offset with Look Up or Lx>ok Down. If any character in the line is offset Up, the 
minimum line height, including leading, is given by the font size of the character, plus its offset; i.e., characters offset Up 
are allowcti to cat into the leading. If a character is offset Down, the largest such offset must be added to obtain the 
line height: i.e., characters offset Down are nol allowed to eat into the leading. 
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iNDi'NTING 

Use Look nested to indent material, and Look Nested to cancel the Indentation. Note that this also 
works when you. are typing in. For example, if you type 

CR'=n'= Here are three points: CR'^n^^First ..CR<^Second ..CR'^rhird ..CR<=N^Now we continue ... 
the document will look like this: 

Here are three points: 

First .. 

Second .. 

Third .. 
Now we continue .. 

Use I^ok First if you want to indent the first line of a paragraph, rather than tabs. When you have 
a list of items, it is often nice to wnindent die first line by about 15 pts, especially if the items are 
numbered. For example: 

L This paragraph was formatted with Look Left 120, Look First -15. in order to make the 
number hang out to the left. 

2. To get the first word of the first line to lino up with the left margin on subsequent lines, 
set a tab stop at that point (see section 3.5). 

3. The easiest way to specify the position of the tab stop is to select the first character of 
the second line, using rfd. In this case, of course, the stop is at 120. 

4. Indended paragraphs sometimes look better balanced if the right margin is indented as 
well. Unfortunately, Look nested doesn't do this for you; you have to change the right 
margin yourself using Look Right d. 

Ofi-sets up and down 

Use the smallest offset you can get away with for subscripts and superscripts, since large offsets 
result in wide ugly spaces between the lines. The offset used by Look t (superscript) and Look *■ 
(subscript) arc defined in your user profile (see secdon 4.6); the standard profile sets it to 4 pts. 

3.4 Forms 

Although Bravo will let you begin with a completely empty window and start typing into it, this is a 
bad practice and should be avoided. Instead, you should start out by Getting a template or form 
which will guide you in constructing the document you want. 

An obvious example is a memo form, and you will find one on the file Form.Memo. Start Bravo 
and Get Form.Memo into the window. You will see that it has spaces for the sender, receiver, date 
and subject, and that these are filled in with words which indicate what should go there. To fill in 
the form, select each of these words, and Replace it with the proper text. Then do the same with 
the MivMOBODY. When you are done, you have a completed memo which you can file under a 
suitiiblc name using Put. Be careful not to Put the document back onto die file from which the 
form came. The best way to avoid doing this is to edit the file name in the black bar above the 
document immediately after Getting the form. 

Your disk comes equipped with a few forms; you can see their names by typing form, tab to the 
hxccutive. You should construct your own forms for other kinds of documents which~7ou find 
yourself creating frequently. As you have seen in the description of Bravo's fomatting features 
rn !i°' ^ \^ ^^^^ contain a great deal of information in addition to standard text and spaces to be 
filled in. You will find that your life is easier and your work is more uniform and of higher quality 
if you use forms consistently, and take the trouble to carefully design a new one when necessary 
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3.5 White space and tabs 

When you type on a typewriter, you can get white space to appear between characters by typing 
spaces or tabs. You can get blank lines by typing carriage returns. In Bravo, you can do exactly 
the same things, with exactly the same results. Space, tab and CR are characters which are in your 
document exactly like "a", "b" or "c". You can get Bravo to display them as special, visible 
characters by selecting the text in which you want to sec them, and typing 

Look visible (tliis must be a lower-case v). 

'I'o turn off the display and just see the usual white space, type 

Look Visible (this must be an upper-case V). 

Normally you don't have to type any CRs; Bravo will automatically end a line when there is no 
room for the next word. You can force a line to end by putting in a CR; this is appropriate when 
you want to control the layout of the text precisely, as in a table. Otherwise, don't put in CRs. You 
should use crRi,-CR to end a paragraph, as described in section 3.2. 

Bravo allows you to set up to 14 tab stops, which are named by the digits 1-9 and the letters abcde. 
The tab stops are paragraph looks, just like the margins; hence they can be different fnr each 
paragraph. You can set a tab stop witli the command 

Look tab t d 

where / is a digit or one of the letters abcde, and d \s a distance (see secdon 3.2). 

When you strike the tab key during typcin, the caret moves to the next tab stop, just as it docs on 
a typewriter, and a lAB character is added to the document. This tab character is called a plain- 
lab, because it moves the caret to tlie next tab stop, not to a specific named tab stop. 

I'or example, suppose you have a line like this: 

Column 1 Column 2 Column 3 

Tab stops 1, 2', and 3 arc at 180, 265 and 400 points, and there is a plain-tab between each digit and 
the following C. If you now append some x's to the digit 1 to get past tab stop 1, the result will 
look like this: 

Column Ixxxxxxx Column 2 Column 3 

Hiat is, the point to which a plain-tab jumps depends on the width of the preceding text. This can 
vary both when you change the text and when you switch to hardcopy mode; thus, the appearance 
of hardcopy may not match the screen if you are using plain-tabs. 

You can turn a plain-tab into a named-tab by selecting it and issuing the command Look ^ t (Look 
comma 0. where / is the name of a tab stop. A named TAB character will always make the 
following character print at the correspondingly named tab stop. If printing has already passed that 
tab stop. Bravo will start a new line, and display a heavy black rectangle at the end of the previous 
line, to warn you that something is wrong. 

To continue the above example, suppose you name tlie first TAB 1 and the second 2. Now the 
result will look like this: 

Column Ixxxxxxxl 

Colunm 2 Column 3 

When you switch from norma! display mode to hardcopy mode, there will usually be more white 
space occupied by tlie tab (perhaps enough to permit printing all the text on one line), but 
everything will continue to be positioned horizontally in exactly the same way. . 
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You can find out the name of a tab stop by selecting it and giving tlic Look ? command. 

Caution: the I^ok comma command should be applied only to TAB characters. If applied to a character other than 
TAB, it will invoke some unsupported features for color printing. 

For compatibility with old versions of Bravo, and with the programmer-oriented tab conventions of 
the Alto and Maxc, you can set unnamed or plain tab stops spaced at equal intervals with the 
command 

Look TAB =_ d 
where the distance d specifies the interval. If you don't set any tab stops, you get plain tab stops 
spaced at 36 pts (this parameter comes from the user profile, and can be changed; see section 4.6). 

One final word about white space: Bravo has formatting features, described in the section on 
paragraphs above, whicli allow you to indent the first line of a paragraph, and to put blank space 
above a paragraph, without using spaces, tabs or extra CRs. It is good practice to use these features, 
since you can control the spacing much more precisely and don't have to worry about having extra 
characters cluttering up your document. 

3.6 Page formatting 

'i'hcrc are a number of features to help you in controlling the layout of your document on printed 
pages. Unlike the horizontal layout, the location of page breaks and the headings, page numbers 
etc. for tlie most part cannot be displayed on the screen. There is, however, a page boundary 
command which allows you to sec on the screen where the page boundaries will appear in the 
hardcopy. The command is invoked by the [,F key. It assumes that the first character of the 
current selection is the first character on a hardcopy page, and it moves the selection to the first line 
of the next page. By applying the page boundary command repeatedly, you can move through the 
document, page by page (or column by column, if your document profile specifies multiple 
columns; sec below). Alternatively, if you know where one page break is (perhaps because of a 
control-L in the previous line; see below), you can start there. If you want to start at the beginning 
of the document, you can use the Iwerything command to make the first character of the document 
be the first character of the selection. 

As a convenience, the page boundary command leaves the original selection at the top of one 
subwindow, and the first line of the next page as the third line of the next subwindow (which it 
creates if necessary). Among other things, this makes it easy to do some editing near the end of the 
page, and then rcselect the beginning of the page and repeat the command. Try it. 

Normally, Bravo will start a new page when it runs out of room on the current page, i.e., when the 
next line to be printed would intmde on the bottom margin, or at the beginning of a paragraph if 
tl\e amount of space left before the botom margin is less than tlie paragraph's keep value. You can 
force a page break by including a IJ^ (control-L) in the text; the line containing the IP will stay on 
the same page, but the next line will start a new page. This character is displayed as a lower-case L 
with an over-bar. You can't type it in simply by holding down CTRL and typing L, but instead you 
can type an L followed by S*^. You do this during an insertion, not as a command, 'i'he L"^ is 
treated just like any other character during editing. 

You can also force a paragraph to start a new page by giving it a keep property of LI". If you want 
to position the paragraph precisely on the ncv/ page, give it a vertical tab property as well. 

You can exercise some control over where page breaks occur with the command 

Look Keep d d is a distance 

This sets the paragraph properly called keep, which has the following meaning. During hardcopy, 
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when printing of the paragraph is begun, the amount of space left on the page before the bottom 
margin must be at least the keep distance, or a new page will be started. For instance, by setting 
the keep of a heading to the total height of the heading (including its leading) plus the height of 
the first two lines of the next paragraph, plus the paragraph leading, you can ensure that the 
heading will never end up alone at the bottom of a page. Good values to use, with standard fonts 
and leading as in this document, are 40 pts on ordinary paragraphs and 80 pts on headings. 

You can set the vertical position of a paragraph precisely on a page using the vertical tab property, 
which is set by the command 

L-ook Z rf d is a distance. 

When a paragraph with a vertical tab is printed, its upper edge (including leading, if any) will be 
positioned at the vertical tab value, measured from the bottom of the page (i.e., use 10.5" to put it 
.5" from the top). Unlike a horizontal tab, which may start a new line, a vertical tab never starts a 
new page; instead, it may cause overprinting. Vertical tabs arc useful for positioning headings and 
footnotes, and for precisely aligning text to meet some physical constraint, such as a pre-printed 
form or a window envelope. The first line of a paragraph with a vertical tab will be printed on the 
current page, even if it runs into the bottom margin (but not if the paragraph also has a keep 
property which forces it off the page). 

Vertical tab and keep properties are not visible on tlie screen, but you can always use Look ? to 
find out whether a paragraph has them, and what their values are. 

Note that both line and paragraph leading are suppressed for the first line of a page of column. If 
you want white space in front of such a line /, you can use vertical tabs, or introduce a blank line in 
front of line /, and adjust the leading of / to compensate for the height of the blank line. 

The remaining aspects of page formatting can be controlled by an optional document profde which 
you can put at the very beginning of the document. The document profile is a sequence of 
paragraphs, each of which must have the profde property. This property is set and cleared by a 
Look command: 

Look ; sets the profile property Look shift : clears it 

A document profile has the following form (tliis one is the profile for this part of this manual): 

Page Numbers: Yes X: 527 Y: -.5" First Page: 40 Not-on-first-pagc 

Private Data Stamp: No X: 3.5" Y: -.6" 

Columns: 1 Edge Margin: .6" Between Columns: .4" 

Margins: Top: 1.3" Bottom:!" Binding: -5 

Line Numbers: No Modulus: 5 Page-relative First Line: I 

Odd Heading: Not-on-first-page 

Bravo Manual 
Even Heading: 

Section 3: Formatting 

Any of the lines may be omitted, and in general any of the fields on a line may be omitted. Fields 
on a line are separated by one or more spaces. Distances, shown in inches in the example, may be 
given in points or centimeters, as described in section 3.2. X coordinates arc from die left edge of 
the paper. Y coordinates from the bottom; negative coordinates are measured from the right edge 
or top of an 8.5" x 11" page. Bravo's measurements on the page are exact to less ihan .01". Actual printers, 
however, can make errors in positioning the text on the page of as much as .25" in any direction. These errors do not 
affect the relative positions of characters (e.g., the length of a line cannot be affected) but they can cause the text to shift 
around on the page as a whole. 

We now proceed to explain the various options. 
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Page Numbers 

ITie coordinates of the page number are the coordinates of the upper right corner of the number. 
You can add Roman to the line if you want Roman numerals for your page numbers, and 
Uppercase if you want the Roman numerals in upper case. If Not-on-fust-page is present, the page 
number is not printed on the first page of the document. If First Page is not specified, it is 
assumed to be I, and Not-on-first-page is also assumed for both page numbers and heading; i.e., 
there will be no page number or heading on p.'.ge 1 in the default case. 

Each page number's looks are copied from the first character of the heading printed on the same page, if there is one, 
or from the first character of the document otherwise. 

The coordinates of the private data stamp are for its upper right corner. Do not use a private data stamp without 
proper authorization. You will need to supply a password on each hardcopy to get the private daU stamp applied; see 
your laboratory manager to learn the password if you have a legitimate need. 

Margins 

The top margin specifies the amount of white space at the top of the page. The bottom margin 
specifics tlic minimum amount of white space at the bottom of the page; a line will .;:art a new 
page if any part of it intrudes into the bottom margin. Exception: if a paragraph has a vertical tab, 
its first line will be printed without regard to the bottom margin, and it may be positioned without 
any regard to the top margin. 

If Binding appears, it is assumed that the pages arc eventually to be printed on both sides of the 
paper, widi odd-numbered pages on the right side of the resulting double spreads. Page numbers 
of even pages will be reflected left-to-right; in the example, even page numbers will have their 
upper left corner at X: .5" Y: .5". The binding distance is the amount of extra margin to be 
supplied on the inner side of the page, which abuts the binding. This amount is added to all the X 
coordinates on odd pages and subtracted from all the X coordinates on even pages. For example, if 
you want 98 pt (1.36") outside margins and 72 pt (1") inside margins, use a left margin (Look Left) 
of 85 pt (the default), and a right margin (Look Right) of 612 (8.5") -85 = 527 (also the default) to 
center the text on the page. 'Ihen use a Binding of 72-85= -13. In general, the rule is: 

Let d = (desired outside margin + desired inside margin)/2 

Look Left d 

Look Right 612 (8.5") - d 

Binding: desired inside margin — d. ^ 

This rule will lead to a negative binding if tlie inside margin is less than the outside margin; that is 
perfectly all right. 

Multiple-column Printing 

The columns line is relevant only for multiple-column pages. It says that the hardcopy should have 
Uie specified number of columns, with the nominal edge margin (at both edges) specified (.6" in the 
example), and the amount of space between columns specified (.4" in the example). If the number 
of columns in the example is changed to 2, the nominal horizontal layout of an odd page will be: 

.6" edge margin; 3.45" text, column 1; .4" between columns: 3.45" text, column 2; .6" edge margin 

for a total of 8.5". The text is centered on the page; if a Binding is specified, the text will be 
displaced in opposite directions on odd and even pages, just as for single-column text. The width 
of the text in tlie columns (3.45 in this example) is determined by subtracting all the other space 
from the 8.5" page width. If there are nc columns, the column width is 

col width = (8.5" - 2*(edge margin) - (/ic-l)*(between cols))/«c 
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The text width and position specified above is only nominal: the actual width and position is 
determined by the specified left and right margins in the following way. The first column is printed 
exactly as its left and right margins specify. The second column is moved right by (col width + 
between cols) from what its left margin specifics (i.e., that amount is added to all its X coordinates). 
This means, for example, that you can get a double-column page with some text at Uie top which 
runs all the way across by setting the right margin of the full-width text appropriately, and using a 
vertical tab to position the first paragraph of the second column below the full-width text. The 
appearance of the resulting page will be 

Full-width text 

first-col text second-col text 



Note that to do this you must manually find the end of the first column (easily done using the page 
boundary command), and put a suitable vertical tab property on the first paragraph of the second 
column. 

A consequence of this laisscz-faire approach to column formatting is that you must supply the 
proper left and riglit margins yourself To keep the text within the nominal boundaries defined 
above, the left margin should be greater than or equal to the edge margin specified in the document 
profile, and die right margin should be less than or equal to the edge margin plus the column 
width. 

The edge margin specified in the example, which would be much too small for single-column pages, 
is good for double-column. It is also desirable to reduce the top and bottom margins when you are 
printing double-column, e.g.; to .8" and .4" respectively. 

When you are printing more than one column, a L*^ in the document starts a new column rather 
than a new page. To start a new page, use two consecutive L"^ characters. 

Ljne Numburs 

If there is a line which says 

Line Numbers: Yes Modulus: « Page-relative First Line: / 

every nth line will be numbered, slightly to the left of the standard left margin. Thus, if n is 5, the 
numbers will be 5, 10, 15 .... If Page-relative appears, numbering starts over on each page; 
otherwise it continues tliroughout the document. If First Line appears, the first line is numbered / 
and numbering continues from there; otherwise the first line is numbered 1. 

HliADINfGS 

If a Heading line appears, it must be followed by a paragraph, also with the profile property, which 
is used as the heading on each page. This paragraph should have a vertical tab which positions it 
correctly (for example, 10.5" for the heading on Uiis page) and appropriate margins, centering or 
whatever to produce the desired effects, it may have more than one line. It is also possible to have 
separate Odd Heading and Kvcn Heading paragraphs. If Not-on-first-page is present, the heading 
will not be printed on the first page. 
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4. Other things 

In this section you can learn about a wide variety of other useful things Bravo can do. They are 
described more-or-less in order of cost-effectiveness: the earlier ones will probably give you more 
payoff per unit of effort to learn them. 

4.1 Some useful features 

This section describes a number of features which are easy to learn and helpful to use. As always, 
it is a good idea to try them out as you read about them. 

You can select entire lines of the document by moving the cursor into the line bar, which is to the 
left of the text area and to the right of the scroll bar. You can tell that you are in the line bar 
because the cursor will appear as a right-pointing aiTow when it is in the line bar. To select the 
entire line pointed to by the cursor, use the RED mouse button. To extend the selection, use the 
ULUH button. Both of these work very much like selecting a character and extending. The yellow 
button selects a paragraph; you can read about paragraphs in section 3.2. 

To put the current selection at die top of the screen, say Normalize. 

To insert the current date and time in front of the current selection, say Time. Notice that it leaves 
just the time selected, so if you follow it immediately with a Delete, you will be left with just the 
date. To replace some text with the current date, select it and say Delete Time Delete; be sure you 
understand why this works. 

You can search the document for the next occurrence of some text with the Jump command. After 
you say Jump, yon have to specify the text you want to search for, and you do Uiis exactly the way 
you make an insertion: by typing it in (ending with ESC), by making a copy selection, or by typing 
vsc to default to tlie same text which was used for the last Jump (not the last insertion or deletion). 
Notice that if you type in text, it appears between the right-most set of curly brackets in tlic system 
window; this is called the search key buffer, and it normally contains the last text you searched for. 
However, the contents of this buffer are destroyed by the Look ? command and some of the Calculator commands. 
The search starts with the second line displayed in the window. If it succeeds, it brings the first 
occurrence of the text to the top of the window; if it fails, a note in the system window informs 
you. Jump does not affect the current selection. The search ignores the looks of the characters. 

You can substitute one text for another using the Substitute command. It will ask you (in the top 
window) for the information it needs. In looking for substitutions it will examine only the text in 
the current selection, so if you want to substitute throughout the document, do an Everything first; 
this will make the entire document the current selection. For reasons you don't want to know 
about, it is not a good idea to do a Substitute in which the old text contains a CR. 

Most Bravo commands can be repeated by simply typing ESC in command mode. When you do 
this, Bravo uses the current selection, not the one which the previous command used. For example, 
you can append a carriage return after each of several words by selecting the first one and 
Appending after it, and then selecting successive words and simply typing ESC. Or, you can search 
through the document looking for occurrences of a word by Jumping to it once and then just typing 
ESC. 

ITie Undo command will undo the action of most Bravo commands which change the document, 
provided you haven't moved the selection. You can only Undo the most recent command; it will 
still work if you have scrolled, however. 
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The ( command will put parentheses around the current selection. You can put other kinds of 
brackets around the current selection with the commands [, i, <, [ and ". 

'I'he ) command expands the current selection as little as possible to make it balanced with respect 
to parentheses. 'Iliis is usefiil primarily while editing algebraic expressions or programs. For 
example, if the current selection is the underlined character in 

"^n+l ~ ^(^^n^ "^^^ (m+1) + c) mod m 
then one application of the } command will extend the selection thus: 

^n+l ~ ((^'^n^ Jnod (m+1) + c) mod m 
and another application will do this: 

^n+l ~ ((a^n) mod (m + 1) + c) mod m 
Again, die ], i, and > commands do similar things. 

4.2 Windows 

So far you have worked with a single; document in a single window. Bravo will let you work on 
several documents at the same time, each in its own window. This is convenient if you want to 
compare two documents, or copy something from one into another, say from an address list into a 
letter. You can also have several subwindows looking into the same document, which is nice when 
you want to copy something from one part of die document to another, or to check something on 
another page without losing your place. 

At the top of each window, separating it from the one above, is a heavy black bar. hiside this bar 
is the name of the file for the document in the window; this name is set by Get and used by Put. 
It can be edited like any other text. Subwindows, created only by the split operation described 
below, arc separated by horizontal black lines. All the subwindows of a window arc looking at the 
same document, although usually at different parts. If part of the document happens to be 
displayed in several subwindows, any changes to it will appear in all of them, and so will the 
selection underline or the insertion caret. Two different windows, on the other hand, are always 
looking at different documents, and no change to one window can affect the other. You can copy 
text freely from one document to another with a copy selection. 

Some commands, like Jump, Everything, Get, Put and Hardcopy, work on the current window, 
which is the window containing the current selection. 

ITiere are two commands for windows, one for creadng and re-arranging windows, and the other for 
destroying them. Each has three options, selected by the three mouse buttons. 

To create a new window, type Window, move the cursor so that it marks the point where you want 
the new window boimdary to be, and hold down BLun. The new window will appear. As long as 
you keep ni-Ul' down, you can move the cursor around and the top boundary of the new window 
will follow it. When you let go of the button, the boundary will freeze. Try it. Tiic new window 
will be empty, but you can insert or Get into it. 

lo split a window and create a new subwindow, type Window, put the cursor where you want the 
split, and hold down Yi!Li,ow. The new boundary will appear, and it will follow the cursor until 
you release YliLLOW. It is important to understand that after a split you have the same document in 
each subwindow. Scroll one of the subwindows so that some of die same text appears in both 
subwindows, and select some of die common text. Notice diat the selection appeare in both 
subwindows. If you make changes to the document, you will see them in both subwindows. This is 
very different from creating a new window and Getting die same file into it; that is equivalent to 
taking another copy out of a file cabinet. 
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To move a window or subwindow boundary, type Window, put the cursor over the boundary you 
want to move, and hold down RED. The boundary will follow the cursor until you let go of RED. 

You can get rid of a window or subwindow by typing Kill, putting tlie cureor in the doomed 
window, and holding down RED or BLUE for about a second. RED will give the space of the 
window to the window above; BLUE will give it to die window below. Kill YELLOW will clear the 
window; it is equivalent to ]:?vcry thing Delete (except that you can't Undo it). 

If you attempt to Kill the only window showing a document that you have changed and haven't filed with Put, Bravo 
will pause with the message "Type CR to confirm". If you really want to lose the changes you have made to the 
document, type CR; otherwise, type DEL and then file the document using Put 



In summary: 



Window 



Kill 



RED 

YELLOW 
BLUE 



move boundary 
split; new subwindow 
new window 



give space to window above 

clear 

give space to window below 



You can remove the system window from view by striking the unmarked key to the right of 
REnURN. This provides more space on the screen and in Alto memory for your document, and also 
makes subsequent commands execute slightly faster. You can restore the system window by striking 
the same key again. The system window is restored automatically when you make an error, and at 
certain other times when Bravo wants you to see what is in the window. 



4.3 If Bravo breaks 

When Bravo breaks or crashes, what usually happens is that Swat gets called; the manifestation is a 
couple of seconds of whirring from the disk, followed by a mostly blank display on the screen, with 
the words Swat version xx at the top. If this happens, look at the bottom of the screen, where 
there will be a more or less intelligible message. In some cases this message may describe a 
condition you can do something about, e.g., that your disk is full. Or it may inform you of a parity 
error; if this happens repeatedly, you should file an Alto trouble report to get your Alto repaired 
(see section 5.1 of the Alto Non-programmer's Guide). A third possibility is some fairly 
meaningless message describing an internal Bravo malfunction. In any case, after looking at the 
message you should type Kc (if that doesn't work, boot the Alto). Then, if you want to recover 
your work, you can proceed as described below. 

Bravo makes a record of everything you do during a session; the record is called the transcript. It is 
useful for three reasons: 

If Bravo crashes because it has a bug, the transcript can be used to report the problem to the 
people responsible for fixing bugs. 

If Bravo crashes because of a hardware failure of your Alto, a power failure, you accidentally 
pushing the boot button, or whatever, you can recover your work by replaying the transcript. 
In this case, the last few characters you typed may be lost. 

If you make a mistake, like deleting half of the document you have been editing for several 
hours, you can replay the transcript up to the error and then save the document. 
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You can do all these things using a system called BravoBug. Thus, 

> BravoBugCR 

will start replaying yoxir transcript. As the replay proceeds, Bravo will report each command, just as 
it does when you type a command in the usual way. When it is finished, Bravo will say Ready, and 
you can go on editing. It is a good idea to save your work with a Put and start Bravo again. 

Warning: you can only do a replay if you haven't started Bravo up again. Once you restart Bravo 
normally, your chance to replay is lost. 

To report a bug in Bravo and then do a replay, type 

> BravoBug/RCR 

This will deliver to the Bravo maintainers copies of all the files involved in the bug, including the 
transcript, and then start Bravo to do the replay. 

You can control the replay, step by step, as described in this paragraph. To stop a replay which is 
going on, type a space. As soon as the command currently being replayed is finished. Bravo will 
stop and tell you the number of the next command. At this point you can type 

Quick to make typed-in text go in all at once during the replay, rather than one character at 
a time. This is faster, but you don't get to see what is going on. Quick is the normal mode. 

Slow to make typed-in text go in one character at a time. 

. space to replay one more command. Note: only commands which change the text or 
windows are recorded in the transcript, not scrolling operations. 

Proceed to continue replaying at full speed. You can stop the replay again at any point by 
typing a space. 

Break before command n to make the next Proceed stop before command n (of course, it 
will still stop right away if you type a space). This is useful if you know that the first 50 
commands are good, but want to proceed more cautiously after that. Note that after a Bravo 
crash, the Swat display usually tells you the number of the command during which the crash 
occurred. 

Tenninate CR to terminate the replay. After terminating, you can proceed to give ordinary 
Bravo commands. Don't do this unless you are sure that you want to stop replaying, since 
there is then no way to resume it. 

You should try replaying a Tkavo session and using these commands, so that you feel comfortable 
with them. You will then feel much more in control when you have a problem with Bravo or your 
Alto, or make a serious blunder while editing. 

4.4 Arithmetic 

Bravo incorporates a simple calculator, modeled after the Hewlett-Packard 35. The calculator has a 
stack with room for four numbers; while you are using it the top of the stack is displayed in the 
search key buffer, in the lower right corner of the system window. 

To enter a number in your document onto the stack, select it and type \ (enter). To add a number 
in your document to die top of the stack, select it and type +_ (or ^, which is the lower-case 
character on die same key). Similarly, you can subtract with ^, multiply with * (or ^), and divide 
with /. The % command is just like *, except that it divides the result by 100. After any of these 
operations, the top of stack is tlie current buffer, which means that you can insert its contents in a 
document by defaulting the text of the insertion with ESC. 
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If you want to type in a number instead of selecting it, just type the number, and end it with one of 
the calculator commands. The number will appear in the middle buffer while it is being typed. 

You can operate on the top two stack elements, rather than on the current selection and the stack, 
by prefixing the operation with the Calculator command. Thus, to compute (a + b) * (c + d), you 

select a \ (enter) Stack:' a ... 

select b ±_ Stack: a+b 

select c \ Stack: c a+b - - 

select d jf Stack: c+d a+b - - . 

C* Stack: (a+A)*(c+tO - 

This also works for enter: Calculator \ duplicates the top of the stack; if the stack was a b c d, it 
becomes a a b c. 

There are a few more calculator commands which are occasionally useful: 

~ exchanges the top two elements of the stack: abed becomes b a c d. 

t rotates the stack, bringing the second element to the top and the top to the bottom: abed 

becomes b c d a. Four repetitions of t leave the stack where it was. 

Calculator n sets the number of digits after the decimal point to n. It is initialized to 2. All 
calculator arithmetic is rounded. 

Calculator Fixed sets the display to fixed point (the normal mode). 

Calculator Scientific sets the display to scientific notation. 

Calculator Engineering sets the display to engineering notation. 

Calculator Radix n sets the radix, n can be a digit, or Binary, Octal, Decimal or 
Hexadecimal. 



4.5 Other useful features 

BUFI'ERS 

The system window contains three pieces of text enclosed in curly brackets. These are called 
buffers, and they arc used for a variety of purposes, some of which you have already encountered. 
The three buffers are nuinbered, as follows: 

1 {last deletion} 2 {last insertion} 3 {search key} 

One of the buffers is always marked with a "*"; that one is the current buffer, and its contents arc 
usually what is inserted when you default a text insertion by simply typing ESC. 

Commands which insert into buffers, like Jump and Substitute, default to the old contents of the 
buffer being loaded. Get and Put default to the file name already in the window. 

The text in the buffers is always in visible mode, i.e., with spaces, tabs and CRs shown explicitly. 
Furthermore, tabs and CRs don't have tlicir usual effect of leaving white space, because there is no 
room in the system window for these effects. Finally, if diere is too much text to fit in the space 
allowed for the buffer on the screen, the middle of the text is replaced by an ellipsis (...). 

You can force buffer n.to be the current buffer with the command Buffer n mc. You can set the 
contents of buffer n with the command Buffer n followed by typing or a copy selection. 
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Partial Substitution 



ff you want to substitute that" for "this" you can use the Substitute command described in section 
4.5. If you want to change some of the occurrences of "this" to "that", however it is useful to 
know about the Find and Yes commands. "owcvcr, is userui to 

Find is exactly lilce Jump, except that 

the search starts from the end of the current selection, not from the top of the display 
sciectorunchan^edT ^^^ ""^'"^^ *^ ''''""^ becomes the current selection (Jump leaves the 

Sows^'^"*'"''^"^ ^« ^'^P'^'^'^ ^ E^nd ESC. So, to change some "this"es to "that"s, proceed as 

select something before the first place you want to start looking; 
Find this ESC; 

ESC to repeat the Find until you get the one you want to change; 
Replace tiiat esc; 
Find esc; 

Now at each point type KC (i.e., repeat the Find) to make no change and go on to the next 
mis , or Yes to make the same change you made last time and then go on. 

Control and Special Characters 

Bravo normally displays a control character as the corresponding lower-case letter (or whatever) with 
an overbar. If you turn on Look graphic it will try to display the control character from the font (if 

Kol itT^Jriook vS^^^^ ' °'^'''''''' '' ""'^ "^^^^'^ ' ^^'"^ '■''^''"^^'^- ™' ^^ a charactel 

You can't type a control character in directly, but you can type the corresponding regular character 
JoUowed by a S , which converts the preceding regular character into a control character. ' 

Certain font families (notably TimesRoman and Helvetica) contain extra characters, such as accents 
ligatures, and several sizes of dashes and spaces, which are useful in creating ;«." high quaHty 
documents Ihese may be entered as control characters in graphic mode (use I ook graphic) The 
correspondence between control characters and their printed representation! is Is follows. 

Accenlx Each of these has a width of zero so should be typed in immediately before the 
character above which it is to appear. 



« 


es^ 


' 


ks'' 




ps<= 


Ligatures: 




ff 


fs"= 


ffl 


qs*^ 


ffl 


■ rs° 


fi 


ts-^ 


fl 


us*^ 



d s*^ example: 



o 
6 
6 
6 



replaces: ff 

ffi 



ffl 

fi 

fl 
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Quotation marks: 

g gc open single quote 

close single quote (standard apostrophe) 

Note that you can make open and close "double quotes" by using pairs of the 
corresponding 'single quotes'. 

Spaces and dashes: 

II spacebar letter space; here are 10 of them: | j 

II y 8*= figure space: | | 

II os*^ em space: I I 



hyphen: — 
V s"^ en dash: — 

X s*^ minus sign: 

s s*^ em dash: — 



Miscellaneous: 

i . bs<^ 

Q CS*^ 

1 hs'^ 



At the lime this manual was prepared, the special characters had not yet been incorporated into the *.al display fonts 
UntJthtehas bee^ done Uicse characicrs will all appear as black rectangles on the screen. To find out wh.ch control 
character one of these black rectangles corresponds to, turn off its graphic look. 

4.6 The user profile and fonts 

The file User.cm is your user profile, which contains information for various systems about how you 
want them to be set up for your use. The information for each system starts with the name of the 
system in brackets, e.g. [bravo]. Then follow a series of lines of the form 

label: information 
Bravo currently accepts three kinds of information in the user profile: initial and quit macros, 
described in the next section, and font definitions and default parameter settmgs. which are 
discussed here. Look at your User.cm file now, to see how this works. 

Each line of font definition tells 
the number of the font (0 to 9) 
the name and size (in points) of the hardcopy font 

the name and size of one or two screen fonts which can be used to represent that hardcopy 
font on the screen. Bravo will use the first one normally but the second one (if present) in 
hardcopy mode. 

For example, the line 

FONT:0 TIMESROMAN 10 TIMESROMAN 12 TIMF.SROMAN 10 

says that font is to print as 10 pt Times Roman when you generate hardcopy. 

The rest of the line says that font can be represented on the screen by the screen fonts stored on 
files rimcsRomanl2.a1 and I'imesKomanlO.al. which must be present on your disk. Bravo will use 
the 12 pt vci-sion in normal display mode and the 10 pt version in hardcopy mode. I he extension 
"al" is used for screen fonts. There are no files for the bold or italic versions of screen fonts. 
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because Bravo can construct them from the regular version. 

In addition to all the *.al files, you must also have a file called Fonts.widths, which contains 
information about the widths of all the characters in the hardcopy fonts. 

IVarning: A Bravo document file does not contain the association between the font numbers and names used, to create 
that document. If you modify the font defmitions in your user profile, you may encounter problems when you attempt 
to share Bravo documents with other people. 

The user profile also contains settings for 

default left and right margins; 

tab interval; 

Look nested parameters; 

default line leading (used by Look X) and paragraph leading (used by Look Open, Look Q 
and the default for Look Y); 

standard offsets (used by Look t, Look ♦-, and the default for Look Up and Look Down). 

You can change all these settings by editing User.cm in a way which should be obvious; after doing 
this, be sure to initialize Bravo. Except for the default margins, all these settings affect r.nly the 
process of editing the document, and not the document itself. In other words, once a Look nested, 
superscript or whatever has been done, the margins, offset, etc., have been set in the document and 
cannot be affected by subsequent changes in' the user profile. 

There is also a [hardcopy] section in the user profile that is used both by Bravo and by other 
subsystems that generate hardcopy. This contains entries for 

preferred printing format (Press is tlie only reasonable choice at present); 

name of your Press printer; 

the name to be inserted in the "Printed by" field on the break page of the printout (an 
occurrence of "$" is replaced by the name by which you are known to the Alto Executive). 

4.7 Startup and Quit macros 

This section is only for programmers, and is not recommended even for them. 

You can put into your user profile sequences of Bravo commands, called macros, to be executed 
automatically when you start up or quit from Bravo. Each macro is named by a letter. Startup 
macro x will be executed if you start Bravo with 

> Bravo/x . . , CR 

Quit macro x will be executed if you type an "x" instead of CR after typing Quit. 

You can see the format of a macro definition by looking at your user profile. The command 
sequences are just like those which Bravo writes into the transcript (the file Bravo.ts), and can be 
constaicted by actually executing the desired sequence of commands, and then copying Bravo.ts to 
another file and copying the sequence out of that file. There are two exceptions: 

* in place of a selection (which looks like {6,2,123,648}) means the current selection; 

@n in place of typed-in text (which looks like 'tcxt{) means the «th parameter. For startup 
macros the parameters are strings on the command line separated by blanks; the first one 
after Bravo/x is numbered 1. For quit macros, parameters 1, 2 and 3 are the tiarce buffers, 4 
is liie file name for the first window, 5 die file name for the second window, etc. 
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4.8 Press and Diablo hardcopy 

To make a Press file on your disk instead of sending your hardcopy directly to a printer, use the 
File option of the Hardcopy command. It will ask you for the name of the file; the recommended 
name is the name of your document, with the extension replaced by "Press". Once you have made 
this file, you may print it using the EmPress subsystem, store it on a file server to make it available 
to other people (see sections 6 and 7.4 of the Alto Non-programmer's Guide), or give it to PressEdit 
to combine it with otlicr files into a large document (see section 7.6 of the Guide). Warnini,: the 
Press file is typically 50% larger than the document file; be sure you have enough room on your 
disk. 

To send hardcopy to some printer other than your regular one (specified in User.cm), use the 
Hardcopy option 

name ESC 

where name identifies the printer you wish to use. 

For both Press and Diablo printing, you can start printing at a specified page number with the 
Hardcopy option 

Start at page n 

This is mainly useful for Diablo printing. There will usually be a substantial delay while Bravo 
figures out where page n starts. 

To print on the Diablo printer, you can use tlic Diablo option to the Hardcopy command. Before 
doing this, be sure a printer is plugged into your Alto; when you plug or unplug it, turn the Alio 
power off first. This option has an array of sub-options, which you can invoke when it pauses 
before printing each page. At the pause, the system window says "Ready to print page n", and the 
beginning of the text for page n is displayed in the document window (if there is room in Bravo's 
memory). You can then say: 

Repeat last page to prepare to reprint the previous page, instead of the page which was going 
to be printed next. 

Continuous print, to suppress the pause after each page; this is useful if you have continuous 
foims in your printer. You can still stop the printing by typing space during printing, as 
described below. 

space to start printing the page- which Bravo says it is ready to print. 

During printing, you can abort printing of tlie current page at any time by typing a space. You can 
then use the options just described to restart tlie current page (with space) or reprint the previous 
page (with Repeat). If you want to start at another page, use DHL to leave the Hardcopy command, 
give another Hardcopy command, and use the Start at page n option. 

There is a command Look Magnify Diablo that displays the document as closely as possible to the 
way it will appear when printed on die Diablo printer. Look Hardcopy terminates this mode. 
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WHAT MOUSE BUTTONS DO 



SYSTEM 
WINDOW 



DOCUMENT 
WINDOW 




Scroll l>ar 


Line bar 


Text area 


Scroll up 


Select line 


Select character 


Thumb 


Select paragraph 
(Sets cursor to fl) 


Select word 


Scroll down 


Extend 


Extend 



COMMANDS 



The CLR key is the blank key to the right of BS on Alto-I 

or the key labolled BW on Altoll. 
The blank key to the right of RETURN removes or restores 

the system window. 



CHANGING 
TEXT 



Delete selection 
Insert text liefore selection 
Append text after selection 
Replace selection by fexf 

fexf may be typed or selected. 



(These make a now 
paragraph if a paragraph 
is selected.) 



During type In: Backspace character with BS or ctrl-A 
Backspace word with ctrlW 
Separate paragraphs with ctrlCR 
Enter ctrl-char as ctiar cIrl-S 



ESC gets the current buffer. Buffer n ESC makes buffer n current. 



FILING 



MISCELL- 
ANEOUS 



Get to read In a file Hardcopy to print. Options: Copies n Start on page n CR to do it 

ctrl-Z for unformatted text File name .press (no printing) Diablo output, with sub-options: Space to start or ab 

Put to write out a file ©printer-name Black (ignore color) Continuous printing 

File name goes into bar above window. ESC gets you one already there. Can edit file name like any other text. Reprint last page 



Undo works on most recent command. 

ESC repeats most recent command, using current selection. 

Everything selects whole document. 

Normalize moves current selection to top of window. 

([{<'" put indicated brackets around current selection. 

) ] } > extend current selection to closest matching brackets. 

LF takes current selection as top of page, and moves selection to top of next page. 



DEL cancels what you arc doing. 
OuitCR exits from Bravo 
Time inserts current date and time. 
Buffer 1 23 text sets buffer and makes it current. 
ESC Instead of (exf just makes it current. 



Basic looks. Mostly, SHIFT means NOT. Thus, Look b turns on bold, Look B turns it off. 

During type-in, use ctrl-b for bold, etc. In command mode, give the Look command, then the letter alone (no ESC). 
Text; bold - underline (highlight if color) Paragraphs: centered justified 

Italic «-/t sub/superscript q-add6pts open - add 1 2 pts space before paragraph 

visible 0-9 font nested (indent) 

graphic CLR to reset ; document profile 



LOOKS 



standard Fonts 

Times Roman 10 

Times Roman 8 

Logo 24 

Math 10 

Hippo 10 

Times Roman 12 

Holvelica 10 

Helvetica 8 

QachalO 

Helvetica 18 



Left margin; default 85 pt 

F - left margin of first line 

P - left margin of other lines 

Right margin: default 527 pt 

X - space between lines; default 6 pt 

Y - space between paragraphs: default 12 pt 

Z ■ vertical tab; default none 

Keep on current page; default 0; 1 1 " forces 

new page 
TAB n d sets tab stop n (n = 1 -9, ac); default not set 
TAB = d sets even tab stops, defaull 36 pt 



There are samples 
In the manual 



PAGE 
FORMATTING 



Look has more cases, which take a distance as parameter. These cannot be used during type- 
Text: Up raises text; default 4 pts. Paragraphs: 

Down lowers text; default 4 pts. 

, n names a tab ( n =1 -9, a-e) 

. c sets color (c = Black, Cyan, Green, Magenta, Red, Violet, Yellow) 

Distances (measured from left or bottom page edge): 

As a number; in points (72/inch) ■ 123or 123pt. 

in Inches ■ 4.5 or 4.5" or 4,5 in 

in cm ■ 4.5 cm 

in blank widths ■ type that many blanks 
As an increment to current value: + or - followed by a number as above 
As the left edge of a character: select with RED 
As a position on the screen: point with BLUE 
Defaulted to a standard value: type \. 

Look Same selection sets all text looks of current selection to be the same as those ofselection 

Look All selection sets all paragraph looks of current selection to be the same as those of selection 

Look ? displays looks of selected text or paragraph in buffer 3. 

Look hardcopy makes screen match hard -copy. Look Hardcopy clears it. Look Magnify Diablo matches Diablo hardcopy 

The following can be in the document profile; it must be the first paragraph, and have llio profilo property (Look;): 

Private Data Stamp; Yes/No X:d Y:d d is a distance: use - to measure from top or right 

Columns;n EdgeMargin:d Between Column8:d ctrIL causes page (or col) break after current line 

Margins: Top:d Bottom:d Binding:d Use two ctrl-Ls for page break v^ith multiple cols 

Line Numbers: Yes/No Modulus-n Pagerelative First Llne:n ^Iso note Look Keep and Look Z (vert(cal tab) 

Page Numbers: Yes/No X:d Y:d First Page:n Roman Uppercase Not-on-first-page 
Heading or Odd /Even Heading: Not-on-first-page followed by a heading paragraph, also with profile property 



WINDOWS 



Window RED to move boundary Kill RED lo merge with window above 

YELLOW to split (make new subwindow) YELLOW to erase contents, leave the window 

BLUE to make new window BLUE to merge with window below 

Window Edge distance sets the left edge of the window at the specified point on the page; default Is 85 pt. 

Jump (exf starts search at second line, doesn't move selection 
SEARCHES Find (exf starts search after current selection, moves selection to the string found 

Substitute fexf for fexf - works on current selection. Usually you want to do Everything first. 
Yes is equivalent to Replace ESC Find ESC; use Yes when you want to confirm substitutions. 



REPLAY 



ARITHMETIC 



>Biavobug will start a replay. >8ravobug/R will report a bug to the Bravo maintainors firsi, then replay. 

Space will slop the replay and show you the number of the next command. You can then type: 

Slow to slow down typein Space to replay one more command Break n to stop before command n 

Quick to speed it up Proceed to continue replay full speed Terminate CH to stop replaying 

Operators are -f = •*<-%/ \(enter). An operator as a command combines the selection with the top of stack. 
You can also type a number, followed by an operator. The stack is just like the one In a Hewlett-Packard calculator. 
Also: ~ exchanges x and y Calculator, with options: Fixed operator to operate on x and y 

t rotates the stack Scientific 0-9 to s<;t digits alter decimal pt 

Engineering Radix n to set the radix (n = H for hex) 
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Alto Pup File Transfer Program 



FTP Is a Pup-based File Transfer Program for moving files to and from 
an Atto file system. The program comes in 3 parts: 

1) An FTP Server, which listens for file transfer requests from 
other hosts, 

2). An FTP User, which initiates file transfers under control of 
either the keyboard or the command line, and 

3) A User Telnet for logging into a remote host using the Pup 
Telnet protocol. 



1. Concepts e.'d Terminology 

Tranferring a file from one machine (or "host") to another over a 
network requires the active cooperation of programs on both machines. 
In a typical scenario for file transfer, a human user (or a program 
acting on his behalf) invokes a program called an "FTP User" and 
directs it to establish contact with an "FTP Server" program on another 
machine. Once contact has been established, the FTP User initiates 
requests and supplies parameters for the actual transfer of files, 
which the User and Server proceed to carry out cooperatively. The FTP 
User and FTP Server roles differ in that the FTP User Interacts with 
the human user (usually through some sort of keyboard Interpreter) and 
takes the Initiative in user/server interactions, whereas the FTP 
Server plays a comparatively passive role. 

The question of which machine is the FTP User and which Is the FTP 
Server is completely independent of the direction of file transfer. 
The two basic file transfer operations are called "Retrieve" and 
"Store"; the Retrieve operation causes a file to move from Server to 
User, whereas Store causes a file to move from User to Server. 

The Alto FTP subsystem contains both an FTP User and an FTP Server, 
running as independent processes. Therefore, to transfer files between 
a pair of Altos, one should start up the FTP subsystem on both 
machines, then issue commands to the FTP User process on one machine 
directing it to establish contact with the FTP Server process in the 
other machine. Subsequent file transfers are controlled entirely from 
the FTP User end, with no human intervention required at the Server 
machine. 

Transferring files to or from a Maxc system or an IFS Involves 
establishing contact with FTP Server processes that run all the time on 
those machines, ilence, one may simply invoke the Alto FTP subsystem 
and direct Its FTP User process to connect to the machine. 

In the descriptions that follow, the terms "local" and "remote" are 
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relative to the machine on which the FTP User program is active. That 
is, we speak of typing conmands to our "local" FTP User program and 
directing it to establish contact with an FTP Server on some "remote" 
machine. A Retrieve command then copies a file from the "remote" file 
system to the "local" file system, whereas a Store command copies a 
file from the "local" file system to the "remote" file system. 

Furthermore, wo refer to "local" and "remote" filenames. These must 
conform to the conventions used by the "local" and "remote" host 
computers, which may be dissimilar (for example, Alto versus Maxc). 
The Alto FTP knows nothing about Maxc filename conventions or vice 
versa. 

The Alto FTP subsystem also includes a third process, called a "User 
Telnet", which simulates a terminal in a manner exactly analogous to 
the Chat subsystem (though lacking some of its finer features). By 
this means, you may log in to a file sytom machine to perform 
operations not directly available via the basic file transfer 
mechanisms. If you log into Maxc, it is even possible to run "PupFTP", 
the Maxc FTP User program, and direct it to estab'Iish contact with the 
FTP Server in your own Alto. You should probably not try this unless 
you really understand what you are doing, however, since the terms 
"local" and "remote" are relative to Maxc rather than to your Alto 
(since the FTP User program is running on Maxc in this case), which can 
be confusing. 



2. Calling the FTP Subsystem 

A number of options are available when running FTP. The program 
decides which parts of itself to enable and where user commands will 
come from by inspecting the command line. The general form of the 
command line to invoke FTP looks like:, 

FTP[/<Global-switches>] [<Host-name> [<Command-l ist>] ] 

The square brackets denote portions of the command line that are 
optional and may be omitted. 

Global switches, explained below, select some global program options 
such as using the Trident disk instead of the Diablo. The first token 
after the <global-switches>, if present, is assumed to be a <host-name> 
(a discussion of which appears later in the description of the "Open" 
conmiand). The User FTP will attempt to connect to the FTP Server on 
that host. After connecting to the server, if a <command-l ist> is 
present, an interpreter is started which feeds these commands to the 
User FTP. When the command list is exhausted, FTP returns to the Alto 
Executive. If no command list is present, an interactive keyboard 
conunand interpreter is started. 

Each global switch has a default value which is used if the switch Is 
not explicitly set. To set a switch to 'false' proceed it with a 
'minus' sign (thus FTP/-S means 'no Server'), to set a switch to 'true' 
just mention the switch. 

Switch Default Function 
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/S true [Server] starts the FTP Server. The Server 1s not 
started if the User is enabled and is being 
controlled from the command lino. 

/U true [User] starts the FTP User. As explained above, the 

interactive command interpreter or the command line 

interpreter will be started depending on the 
contents of the command line. 

/C true [Chat] starts the Telnet. The Telnet is not started 
if the User is enabled and is being controlled from 
the command line, or if the system disk is a 
Trident. 

/T false [Trident] sets the system disk to be a Trident 
drive. The default is 0, but can be changed by 
following the /T with a unit number. The unit 
number is octal; the high byte is the logical 
filesystem number and the low byte is the physical 
drive number. User and Server commands apply to 
files on this disk but command line input is still 
taken from Com. cm on the Diablo drive. 

/L • [Log] causes all output to the User FTP window to 
also go to the file "FTP. log" on DPO, overwriting 
the previous contents. Log is true if the User is 
enabled and is being controlled from the command 
1 ine. 

/A false [AppendLog] enables the log but appends to FTP. log 
rather than overwriting it. 

/E true [Error] causes FTP to ask you if you want to 
continue when a non-fatal error happens during 
execution of a command line. FTP/-E will cause FTP 
to recover automatically from non fatal errors 
without consulting you. ■ 

/R true [Ram] allows FTP to use some microcode which speeds 
things up slightly. If your Alto has no ram, this 
switch is ignored. 

/D false [Debug] starts FTP in debug mode. 

The rest of the global switches are explained below under 'Server 
Options'. 

2.1. FTP User Log 

FTP can keep a log (typescript) file for the FTP User window. The file 
name is 'FTP. log'. It is always enabled when FTP is being controlled 
from the command line; otherwise it is controlled by the /L and /A 
global switches. 
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2.2. Using a Trident Disk 

Starting FTP with the /T global switch causes FTP to store and retreive 
files from a Trident disk. By default, FTP will open TPO; other disks 
may bo opened by appending their unit numbers to the /T switch. Thus 
"FTP/fl" will open TPl, and "FTP/T400" will open logical filesystem 1 
on physical unit 0. 

Accessing a file on a Trident requires more code and more free storage 
than accessing a file on the Diablo. Since FTP is very short on space, 
only a User or a Server FTP is started when the /T switch is set. The 
default is to start a User FTP, but specifying no user (FTP/T-U) or 
specifying a server (FTP/TS) will start a Server FTP instead. 

2.3. Server Options 

Server options are controlled by switches on the subsystem name and 
subcommands of the SERVER keyboard command. There are currently four 
options: 

switch Default Function 

none If no server option is specified, retrieve requests 

(disk to net) are allowed. Store requests (net to 
disk) are allowed unless the store would overwrite 
an already existing file. Delete and Rename are not 
permitted. 

/P false [Protected] Retrieve requests are allowed. No 
stores are allowed. Delete and Rename are not 
permitted. 

/O false [Overwrite] Retrieve requests are allowed. Store 
requests can overwrite files. Delete and rename are 
permitted, 

/K false [Kill] FTP will return to the Alto Exec when the 

server connection is closed. A simple form of 

remote job entry can be performed if the user FTP 

stores into Rem. cm (Com. cm on Novas). 



3. The FTP Display 

The top inch or so of the display contains a title line and an error 
window. The title line displays the release date of that version of 
FTP, the current date and time, the machine's internetwork address, and 
the number of free pages on the disk. The error window displays 
certain error messages if they arrive from the network (errors are 
discussed in more detail below). A window is created below the title 
line for each part of FTP which is enabled during a session (server, 
user, and telnet). 

If the FTP Server is enabled, it opens a window and identifies Itself. 
If a User FTP subsequently connects to this Server, the User's network 
address will be displayed. The Server will log the commands It carries 
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out on behalf of the remote User In this window. The Server is not 
enabled when FTP Is being controlled from the command line. 

The FTP User opens the next window down and identifies itself. The 
command herald is an asterisk. 

The User Telnet opens the bottommost window, identifies itself, and 
waits for a host name to be entered. The Telnet is not enabled when 
FTP is being controlled from the command line. 



4. Keyboard Command Syntax 

FTP'S Interactive command interpreter presents a user interface very 
similar to that of the Alto Executive. Its command structure is also 
very similar to that of the Maxc Pup FTP program (PupFTP), and the Maxc 
ArpaNet FTP program (FTP). The standard editing characters, command 
recognition features, and help facility (via "?") are available. When 
FTP 1s waiting for keyboard input, a blinking cursor appears at the 
next character position. 

4.1. Directing Keyboard Input to the User and Telnet 
. Windows 

The bottom two unmarked keys control which window gets characters from 
the keyboard. Hitting the unmarked koy to the right of 'right-shift' 
(also known as the 'Swat key') directs keyboard Input to the Telnet 
window. Hitting the unmarked key to the right of the 'return' key 
(also known as the 'Chat key') directs keyboard input to the FTP User 
window. The window which currently owns the keyboard will blink a 
cursor at the next character position if it is waiting for type-in. 

4.2. Keyboard Coinmands 

OPEN <host name> 

Opens a connection to the FTP Server in the specified host. FTP 
permits only one user connection at a time. In most cases the 
word OPEN may be omitted: i.e., a well formed <'host name> is a 
legal command and implies a request to OPEN a connection. FTP 
will try for one minute to connect to the specified host. If you 
made a mistake typing the host name and wish to abort the 
connection attempt, hit the middle unmarked key (to the right of 
<return>). 

Ordinarily, host name should be the name of the machine you wish 
to connect to (e.g., "Maxc"). Most Altos and Novas have names 
which are registered in Name Lookup Servers. So long as a name 
lookup server is available, FTP is able to obtain the information 
necessary to translate a known host name to an inter-network 
address. 

If the host name of the server machine is not known or If no name 

lookup servers are available, you may specify an inter-network 

address in place of the host name. The general form of an inter- 
network address is: 
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<network> * <host> # <socket> 

where each of the three fields is an octal number. The <network> 
number designates the network to which the Server host is 
connected (which may be different from the one :o which the User 
host is connected); this (along with the "#" that follows it) may 
be omitted if the Server and User are known to be connected to the 
same network. The <host> number designates the Server host's 
address on that network. The <socket> number designates the 
actual Server process on that host; ordinarily it should be 
omitted, since the default is the regular FTP server socket. 
Hence, to connect to the FTP server running in Alto host number 
123 on the directly-connected Ethernet, you should say "OPEN 123#'' 
(the trailing "#" is required). 

CLOSE 

Closes the currently open User FTP connection. CLOSE cancels any 
defaults set by CONNECT, DIRECTORY, DEVICE, BYTE, TYPE, or EOLC 
conmands. 

LOGIN <user name> <password> 

Supplies any login parameters required by. the remote server before 
it will permit file transfers. FTP will use the user name and 
password in the Operating System, if they are there. Logging into 
FTP will set the user name and password in the OS (in the same 
manner as the Alto Executive's "Login" command). 

When you issue the "Login" command, FTP will first display the 
existing user name known to the OS. If you now type a space, FTP 
will prompt you for a password, whereas if you want to provide a 
different user name, you should first type that name (which will 
replace the previous one) followed by a space. The command may be 
terminated by carriage return after entering the user name to omit 
entering' the password. 

The parameters are not immediately checked for legality, but 
rather are sent to the server for checking when the next file 
transfer command is issued. If a command is refused by the server 
because the name or password is incorrect, FTP will prompt you as 
if you had issued the LOGIN command and then retry the transfer 
request. Hitting delete in this context will abort the command. 

A user name and password must be supplied when transferring files 
to and from a Maxc system or an IFS. The Alto FTP Server requires 
a user-password to be supplied if the server machine's disk is 
password-protected and if the password in the server machine's OS 
does not match the password on the disk. Thus if the OS was 
booted and FTP invoked because a Request-for-Connection was 
received (which bypasses password checking), FTP will refuse 
access to files unless a password is supplied. However if the OS 
was booted normally, FTP assumes that the disk owner (who knew the 
password) will control access by using the server option switches. 
The user-name is ignored. 

CONNECT <directory name> <password> 

Requests the FTP server to "connect" you to the specified 
directory on the. remote system, i.e., to give you owner-like 
access to it. The password may be omitted by typing carriage 
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return after the directory name. As with LOGIN, these parameters 
are not verified until the next transfer command is issued. 
CONNECT cancels the effect of any previous DIRECTORY command. At 
present, the "Connect" command Is meaningful only when 
transTerring files to or from a Maxc system or an IPS; the Alto 
FTP server currently Ignores connect requests. If the "multiple 
directory" feature of the Alto Operating System ever comes into 
widespread use, this may be changed. 

DIRECTORY <di rectory name> 

Causes <di rectory name> to be used as the default remote directory 
in data transfer commands (essentially It causes <d1rectory-name> 
to be attached to all remote filenames that do not explicitly 
mention a directory). Specifying a default directory in no way 
modifies your access privileges, whereas CONNECTing gives you 
'owner access* (and usually requires a password). Explicitly 
mentioning a directory in a file name overrides the default 
directory, which overrides the connected directory, which 
overrides the login directory. Punctuation separating <directory 
name> from other parts of a remote filename should not be 
included. For example you might type "Directory Alto" not 
"Directory <Alto>". 

RETRIEVE <remote filename> 

Initiates transfer of the specified remote file to the local host. 
The syntax of <remote f1lename> must conform to the remote host's 
file system name conventions. Before transferring a file, FTP 
will suggest a local-filename (generally the same as the remote- 
filename without directory or version), and will tell you whether 
or not the file already exists on your local disk. At this point 
you may make one of three choices: 

1. Type Carriage Return to cause the data to be transferred to 
the local filename. 

2. Type Delete to indicate that the file is not to be 
transferred. 

3. Type any desired local filename followed by Return. The 
previous local filename will disappear, the new filename will 
replace it, and FTP will tell you whether a file exists with 
that name. This filename must conform to local conventions. 
You now have the same three choices. 

If the remote-filename designates multiple files (the remote host 
permits "*" or some equivalent in file names), each file will be 
transferred separately and FTP will ask you to make one of the 
abovo three choies for each file. At present, only Maxc and IFS 
support this capability. That is, you may supply "'"s in the 
remote-filename when retrieving files from a Maxc or an IFS, but 
not when retrieving files from another Alto. 

STORE <local filename> 

Initiates transfer of the specified local file to the remote host. 
Alto file name conventions apply to the <local filename); "•" 
expansion is not supported. FTP will suggest a remote-filename to 
which you should respond in a manner similar to that described 
under RETRIEVE except that if you supply a different filename, it 
must conform to the remote file system's conventions. The default 
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remote filoname Is one with the same name and extension as the 
local file; the remote server defaults other fields as necessary. 
If the remote host is a Maxc system or, an IFS, then the directory 
is that most recently supplied in LOGIN or CONNECT or DIRECTORY 
commands and the version is the next higher. 

DUMP < remote filename) 

Bundles together a group of files from the local file system into 
a 'dump-format' file (see the Alto Executive documentation for the 
dump-file format and more on dump-files in general) and stores the 
result as <remote filename). FTP will ask you for the names of 
local files to include in the dump-file. Terminate the dump by 
typing Just <return> when FTP asks for another filename. By 
convention, files in dump-format have extension '.dm'. 

LOAD <remote filename) 

Performs the inverse operation of DUMP, unbundling a dump-format 
file from the remote Tile system and storing the constituent files 

in the local file system. For each file in the dump-file, FTP 

win suggest a local file name and tell you whether a file by that 

name exists on your disk. You should respond in the manner 
described under RETRIEVE. 

LIST <remote file designator) 

Lists all files In the remote file system which correspond to 
. <remote file designator). The remote file designator must conform 
to file naming conventions on the remote host, and may designate 
multiple files if "•" expansion or some equivalent is supported 
there. If the (remote file designator) is terminated by <comma 
carriage return) rather than just a <carr1age-return>, FTP prints 
a prompt of '"••" at the left margin and prepares to accept one or 
more subcommands. These subcommands request printout of 
additional information about each file. To terminate subcommand 
input, type a <return) in response to the subcommand prompt. The 
subcommands are: 

Type Print file type and byte size. 

Length Print length of file in bytes. 

Creation Print date of creation. 

Write Print date of last write. 

Read Print date of last read. 

Times Print times as well as dates. 

Author Print author (creator) of file. 

Verbose Same as Type+Write+Read+Author. 

Everything Print all inrormation about the file. 

This information is only as reliable as the Server that provided 
it, and not all Servers provide all of these file properties. 
Altos derive much of this information from hints, so do not be 
alarmed if it is sometimes wrong. 

DELETE < remote filename) 

Deletes <remote filename) from the remote filesystem. The syntax 
of the remote filename must conform to the remote host's file 
system name conventions. After determining that the remote file 
exists, FTP asks you to confirm your intention to delete it. If 
the remote filename designates multiple files (the remote host 
permits "♦" or some equivalent in file names), FTP asks you to 
confirm the deletion of each file. 
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RENAME <old f1l9name> <new filename) 

Renames <olcl filename) in the remote filosystem to be <new 
filename). The syntax of the two filenames must conform to the 
remote host's file system name conventions, and each filename must 
speciTy exactly one file. 

QUIT 

Returns control to the Alto Executive, closing all open 
connections . 

TYPE <data typo> 

Forces tlie data to be interpreted according to the specified <data 
type>, which may be TEXT. BINARY. Initially the type is 
UNSPECIFIED, meaning that the source process should, If possible, 
decide on the appropriate type based on local information. 

BYTE-SIZE <doc1mal number) 

Applicable only to files of type Binary, BYTE-SIZE specifies the 
logical byte size of the data to be transferred. The default Is 
8. 

EOL <convention> 

Applicable only to files of type Text, EOL specifies the End-of- 
l-lne Convention to be used for transferring text files. The 
values for <convention> are CR. CRLF, and TRANSPARENT. The 
default Is CR. 

DEVICE <device> 

Causes <device) to be used as the default device in data transfer 
commands (essentially it causes <dev1ce> to be attached to all 
remote filenames that do not explicitly mention one). The 
punctuation separating <device> from the other components of a 
remote Filename should not be included. For example you might 
specify "Device DSK" to Tenex, not "Device DSK:" 

USER 

Allows you to toggle switches which control operation of the FTP 
User. There is currently only one: DEBUG, which controls display 
of protocol interactions. Warning: this printout (and the 
corresponding one in the SERVER command below) sometimes includes 
passwords. 

SERVER 

Allows you to toggle switches which control operation of the FTP 
Server. The switches are PROTECTED. OVERWRITE, KILL, and DEBUG, 
corresponding to the global switches /P, /O, /K, and /D. 

TELNET 

Allows you to toggle switches which control operation of the 

Telnet. There is currently only one: CLOSE, which closes the 

Telnet connection if one Is open, and clears the Telnet window. 



5. Command Line Syntax 

The User FTP can also be controlled from the command line. As 
explained above, the first token after the subsystem name and server 
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switches must be a legal host name; if the User FTP can't connect to 
the FTP Server on that host it will abort and return control to the 
Alto Executive. If a command list follows the host name, the command 
line interpreter is invoked instead of the interactive keyboard 
interpreter. This permits the full capabilities of the Alto Executive 
(Filename recognition, "•" expansion, command files, etc.) to be used 
1n constructing commands for FTP. 

Each command is of the form: 

<Keyword>/<SwitchL1st> <arg> ... <arg> 

To get a special character (any one of "•#';") past the Alto F.xecutive, 
it must be preceded by a single quote. To get a "/" into an FTP 
argument, the "/" must be proceeded by two single quotes (the second 
one tells FTP to treat the "/" as an ordinary character in the 
argument, and the first one gets the second one past the Alto 
Executive) . 

Unambiguous .abbreviations of command keywords (which 1n most cases 
amount to the first letter) are legal. However, when constructing 
command files, you should always spell commands in full, since the 
uniqueness of abbreviations in the present version of FTP is .not 
guaranteed 1n future versions. 

A command Is distinguished from arguments to the previous command by 

having a switch on It, so every command must have at least one switch. 

The switch "/C" has no special meaning and should be used on commands 
where no other switches are needed or desired. 



5.1. Command Line Errors 

Command line errors fall into three groups: syntax errors, file errors, 
and connection errors. FTP can recover from some of these, though it 
leaves the decision about whether to try up to you. 

Syntax errors such as unrecognized commands or the wrong number of 
arguments to a command cause FTP's command interpreter to get out of 
sync with the command file. FTP can recover from syntax errors by 
simply ignoring text until It encounters another command (i.e. another 
token with a switch). 

File errors such as trying to retrieve a file which does not exist are 
relatively harmless. FTP recovers from file errors by skipping the 
offending file. 

Connection errors such as executing a store command when there is no 
open connection could cause FTP to crash. FTP can't recover from 
connection errors. 



Wh 
window 



on FTP detects an error, it displays an error message in the User 
window. If the error is fatal, FTP waits for you to type any character 
and then aborts, causing the. Alto Executive to flush the rest of the 
command lino, including any commands to invoke other subsytems after 
FTP. If FTP can recover from the error, it asks you to confirm whether 
you wish to continue. If you confirm, it plunges on, otherwise it 
aborts. The confirmation request can be bypassed by invoking FTP with 
the global error switch false {FTP/-E ...) in which case 1t will plunge 
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on after all non fatal errors. If you aren't around when an error 
happens and you have told FTP to get confirmation before continuing 
after an error, the remote Server wHl probably time out and close the 
connection. If you then return and tell FTP to continue. It will get a 
fatal connection error and abort. 

6.2. Command Line Commands 

OPEN/C <host name> 

See description in "Keyboard commands". The first token after the 

subsystem name and global switches is assumed to be a host name 

and no OPEN verb is required (in fact if you supply It, FTP will 

try to make a connection the host named OPEN which is almost 
certainly not what you want). 

CLOSE/C 

Closes the currently open User FTP connection. 

LOGIN/C <user nam9> <pas$word> 

See description in "Keyboard commands". The <password> may be 
omitted. 

LOGIN/Q <user name> 

Causes FTP to prompt you for the password. This form of LOGIN 
. should be used in command- files since including passwords in 
command files is a bad practicd. 

CONNECT/C <di rectory name> <passwor(l> 

See description in "Keyboard commands". The <password> may be 
omitted. 

CONNECT/Q <d1 rectory name> 

Causes FTP to prompt you for tte password needed to connect to the 
specified <directory name>. Ttiis. form of CONNECT should be used 
in command files since includng passwords in command files is a 
bad practice. 

DIRECTORY/C <default directory> 

See discription in "Keyboard commands". 

RETRIEVE/C <remote filename> ... <r(imote fnename> 

Retrieves each <remote f1lGnane>, constructing a local file name 
from the actual remote file narie as received from the Server. FTP 
will overwrite an existing file unless the /N (No overwrite) 
switch is appended to the RETRIEVE command keyword. If the remote 
host allows "*" (or some equivalent) in a filename, a single 
remote filename may result in the retrieval of several files. 
(Note that you must quote the "*" to get it past the Alto 
Executive's command scanner.) As mentioned previously, this 
capability is implemented only by Maxc and IFS FTP Servers at 
present. 

RETRIEVE/S <remote filename> <local fnename> 

Retrieves < remote filename> and names It <local fnename> In the 
local file system. This version of RETRIEVE must have exactly two 
arguments. FTP w1l] overwrite an existing file unless the /N (No 
overwrite) switch Is also appended to the RETRIEVE command 
keyword. The remote filename should not cause the server to send 
multiple files. 
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RETRIEVE/U <reniote filename) ... <remote filename) 

Retrieves <renioto filename) if its creation date is later than the 
creation date of the local file. A file will not be retrieved 
unless a local file with name and extension equal to the name and 
extension of the remote filename exists, or if the FTP server does 
not send a CREATION-DATE property. This optio.; can be combined 
with RETRIEVE/S to rename the file as it is transferred. 

RETRIEVE/V 

Requests confirmation from the keyboard before writing a local 
file. This option is useful in combination with the Update option 
since creation date is not a fool-proof criterion for updating a 
file. 

STORE/C <local filename) ... <local filename) 

Stores each <local filename) on the remote host, constructing a 
remote filename from the name body of the local filename. A local 
filename may contain "*", since it will be expanded by the Alto 
Executive into the actual List of filenames before the FTP 
subsystem is invoked. 



STORE/S <loca1 filename) <remote filename) 

Stores <local filename) on the remote host as <remote filename). 
The remote filename must conform to the file name conventions of 
the remote host. This version of store must have exactly two 
arguments. 

DUMP/C <remote filename) <local filename). .. <local filename) 
See the description in "keyboard Commands". 

LOAD/C <remote filename) ... <remote filename) 

See the description in "keyboard Commands". If the /V switch is 
appended to the LOAD command keyword, FTP will request confimation 
before writing each file. Type <return) to write the file, <d6l> 
to skip it. FTP will overwrite an existing file unless the /N (No 
overwrite) switch is appended to the LOAD command keyword. 

LOAD/U <remote filename) ... <remote filename) 

Loads files from <remote filename) if their creation dates are 
later than the corresponding creation dates of local files. A 
file will not be retrieved unless a local file with name and 
extension equal to the name and extension of the remote filename 
exists, or if no creation date is included in the dump file. 

LOAD/S <remote filename) <filename 1) ... <filename n) 

Loads files from <remote filename) if their names are in the list 
<fnename 1) . . . <filename n). Files within the dump file that 
are not in the list are skipped. This option can be combined with 
the /U, /V, and /N options. 

LIST/C <remote filename) ... <remote filename) 

See the description in "Keyboard Commands". The subcommands are 
specified by local switches: /T = type, /L = length in bytes, /D = 
creation date, /W = write date, /R = read date, /A = author, /V =» 
verbose, /E = everything. Dates always include times; /C should 
have been the creation date but that collides with the use of /C 
to mean no local options (sigh). 

DELETE/C <romote filename) 
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See the description In "Keyboard Commands". If the /V switch Is 
appended to the DELETE command keyword, FTP will request 
confirmation before deleting each file. Type <return> to delete 
the file, and <del> (oops!) if you don't want to delete it. 

COMPARE/C <remote f ilename> , . . <remote filename) 

Compares the contents of <remote filename) with the file by the 
same name in the local file system. It tells you how long the 
files are if they are identical or the byte position of the first 
mismatch if they are not. (No corresponding command is available 
in the Keyboard command interpreter for implementation reasons: 
there is not enough room for it In Alto memory.) 

COMPARE/S <remote filename) <local filename) 

Compares <remote filename) with <local filename). The remote 
filename must conform to the file name conventions of the remote 
host. This version of COMPARE must have exactly two arguments. 

RENAME/C <old filename) <new filename) 

See the 'iescription 1n "Keyboard Commands". 

TYPE/C <data type) 

See the description in "Keyboard Commands". 

BYTE-SIZE/C <decimal number) 

See the description in "Keyboard Commands". 

EOL/C <convent1on) 

See the description in "Keyboard Commands". 

DEVICE/C 

See the description in "Keyboard Commands". 

DEBUG/C 

See the description of the DEBUG subcommand under the USER command 
in "Keyboard Commands". 



6.3. CLI Examples 

To transfer Tiles FTP. run and FTP. syms from the Alto called "Michelson" 
to the Alto called "Morley", one might start up FTP on Michelson (to 
act as an FTP Server), then walk over to Morley and type: 

FTP Michelson Retrieve/c FTP. run FTP. syms 

Alternatively, one could start an FTP server on Morley (invoking it by 
"FTP/0" to permit files to be overwritten on Morley's disk), then issue 
the following command to Michelson: 

FTP Morley Store/c FTP. run FTP. syms 

The latter approach is recommended for transferring large groups of 
files such as "*.run" (since expansion of the "*" will be performed by 
the Alto Executive). 

To retrieve User. cm from the FTP server running on Alto serial number 
123 (name unknown, but it is on the local Ethernet): 

FTP 123'iS' Retrieve User. cm 
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Note that the "iS'" must be preceded by a single quote when included 1n a 
command line, since otherwise the Alto Executive does funny things with 
it. (Quotes are not necessary when typing to FTP'S interactive 
keyboard interpreter). 

To start FTP, ha\,e the FTP User connect to Maxc, and then accept 
further commands from the keyboard: 

FTP Maxc 

To retrieve <System>Pup-Network. txt from Maxc and store it on the Alto 
as PupDirectory. bravo, and store PupRTP.bcpl, Puplb.bcpl, and 
PupBSPStreams.bcpl on <DRG> with their names unchanged: 

FTP Maxc Connect/c drb mypassword Retrieve/s <System>Pup- 
Metwork.txt PupDirectory . bravo Store/c PupRTP.bcpl Puplb.bcpl 
PupBSPStreams . bcpl 

To retrieve the latest copy of all .RUM files from the <alto> 
directory, overwriting copies on the Alto disk (The single quote is 
necessary to prevent the AUo Executive from expanding the "*"): 

FTP Maxc Ret/c <alto>'*.run 

To update the Alto disk with new copies of all <alto> files whose names 
are. contained in file UpdateFiles.cm, requesting confirmation before 
each retrieval: 

FTP Maxc Dir/c Alto Ret/u/v SUpdateFiles .cm0 

To store all files with extension .BCPL from the local Alto disk to 
your login directory on Maxc (the Alto Executive will expand "•.bcpl" 
before invoking FTP): 

FTP Maxc St/c '.bcpl 

To retrieve <System>Host-name/descriptor-f ile . txt ;43 (two single quotes 
are necessary to get the "/" past the Alto Executive and the FTP 
command scanner, and one quote is necessary to get the ";" past the 
Alto Executive): 

FTP Maxc Ret/c <System>Host-name' '/descriptor-file. txt' ;43 

To send Prog.f4, Data.f4, and Command. f4 to Fortran-Machine and then 
cause the FTP server on Fortran-Machine to quit (presumably to execute 
Prog.f4 on Data.f4 according to the commands in Command. f4): 

FTP Fortran-Machine Store/c Prog.f4 Data.f4 Store/s 
Command. f 4 Rem. cm 

FTP on Fortan-Machine must be started with the /K server option switch, 
and Command. f4 should re-Invoke FTP as its last act so that the results 
can be retrieved. 

To release a new version of FTP, I incant: 

0ReleaseAltoFTP.cm0 

which the Alto Executive expands into: 
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FTP Maxc Connect/q AVto Store/c FTP. run FTP.syms Connect/q 
AltoSource Dump/c FTP. dm 9ftp.cm9 

and then Into: 

FTP Maxc Connect/q Alto Store/c FTP. run FTP.syms Connect/q 
AltoSource Dump/c FTP. dm eFtpSubsys.cmS 9FtpPackage.cm8 
FTP. cm 

and finally Into: 

FTP. run Maxc Connect/q Alto Store/c FTP. run FTP.syms 
Connect/q AltoSource Dump/c Ftp. dm Ftp.bcpl FtpNv.bcpl 
Ftplnlt.bcpl Ftplnitl.bcpl F tpNvInlt. bcpl F tpUserlnit .bcpl 
FtpSubsys.decl FtpKbdInit .bcpl FtpKbd.bcpl FtpKbdl.bcpl 
FtpKbd2.bcpl FtpCl iln it.bcpl FtpCli.bcp! FtpClil.bcpl 
FtpC1i2.bcpl FtpCliUtil .bcpl FtpMlscb .bcpl FtpMlsca.asm 
FtpServerlnit.bcpl FtpServer .bcpl FtpTelnotlnIt .bcpl 
FtpTelnet.bcpl FtpKoys.bcpl FtpCmdScanDsp.bcpl FtpMc.mu 
FtpRamTrap.mu CompileFtpmc. cm FtpSubsys.cm 
CompileFtpSubsys.cm CompileAltoFtp.cm LoadAl toFtp. cm 
MakoHiddenFtp.cm LoadHiddenFtp.cm ReleasoAUoFtp.cm 
Comp ileNovaFtp.cm LoadDosF tp . cm LoadRDosFtp. cm FtpProt.decl 
FtpUserProt .bcpl FtpUserProtFile. bcpl FtpUserProtMail .bcpl 
FtpServProtFile.bcpl FtpServProtMail . bcpl FtpPListlnIt .bcpl 
FtpPListProt.bcpl FtpPListl . bcpl FtpUtil In1t . bcpl 
FtpUtilB.bcpl FtpUtilA.asm FtpUtilXf er. bcpl FtpUtilDmpLd . bcpl 
FtpUtilCompB.bcpl FtpUt i ICompA. asm BlockEq.mu FtpOEPInit .bcpl 
CompileFtpPackage.cm DumpFtpPackage.cm FtpPackage.cm Ftp. cm 

To load Ftp. dm from <A1 toSource>, expanding 1t out into its constituent 
files: 

FTP Maxc Load/c <AltoSource>Ftp. dm 

To cause Memo. ears to be spooled for printing on Ears by the Maxc 
printing system: 

FTP Maxc Store/s Memo. ears LPT: 

This also works for Press files and unformatted text files If you know 
what you are doing. U does not do the right thing for Bravo-format 
files. 

To use FTP as a stop-gap IFS: 

FTP/T-UO 

This starts only a server with overwriting of existing files permitted. 
When using the trident, there isn't enough space to start both a User 
and a Server. 



6. File Property Defaulting 

Without explicit information from the file system, it Is often 
difficult to determine whether a file is Binary or Text, if Binary, 
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what its byte-size Is, and If Text, what End-Of-Line convention is 
used. The User and Server FTPS use some simple heuristics to determine 
the correct manner in which to transfer a file. The heuristics 
generally do the right thing in the face of incomplete information, and 
can be overridden by explicit commands from a human user who knows 
better. 

The FTP protocol specifies a standard representation for a file while 
in transit over a network. If the file is of type Binary, each logical 
byte is packed right-justified in an integral number of 8-bit bytes. 
The byte-size is sent as a property along with the file. If the file 
is of type Text, each character is sent right-justified in an 8-bit 
byte. An EOL convention may be sent as a file property. The default 
is that <return> marks the end of a line. 



6.1. File Types 

FTP determines the type of a local file by reading it and looking for 
bytes with thf( high-order bit on. If any byte in the file has a high- 
order bit on, the file is assumed to be Type Binary, otherwise it is 
assumed to be Type Text. FTP will generate a warning, but allow you to 
send what it thinks to be a text file as type Binary, since no 
information is lost. It will refuse to send a binary file as type 
text. 

Don't specify a Type unless you know what you are doing. The 
heuristic will not lose information. 

6.2. Byte-Size 

If a file is type Binary, the byte-size is assumed to be 8 unless 
otherwise specified. The FTP User and Server will both accept binary 
files of any byte-size and write them as 8 bit bytes on the disk. No 
transformation is done on the data as it is written to the disk; it is 
stored in network default format. Since there is no place in the Alto 
file system to save the byte-size property, it is lost. 

Similarly, requests for Binary files will be honored with any byte 
size, and whatever is on the disk will be sent to the net without 
transformation. Since Alto files have no byte size information, the 
byte-size property will be defaulted to 8 unless otherwise specified 
(by the BYTE command), in which case whatever was otherwise specified 
win be sent as the byte size. 

Don't specify a Byte-size unless you know what you are doing. 

Alto-Alto transfers can't go wrong. Alto-Maxc transfers with 

weird byte-sizes will not work unless the byte-size specified 
in the Alto to Maxc direction is the same as the byte-size in 

which the file was stored on the Alto. If it isn't, the Alto 

will not give any error indication, but the result will be 
garbage, 

6.3. End-of-Line Conventions 

FTPS are expected to be able to convert text files between the local 
file system End-Of-Line (EOL) convention and the network convention. 
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Conveniently enough, the Alto file system's internal representation of 
a text file is the same as the network standard (a bare <return> marks 
the end of a line). The Alto FTP does not do any transformations on 
text files. It will refuse to store a text file coming in from the net 
whose EOL convention is CRLF. 

As an escape to bypass conversion and checking, FOL convention 
'transparent' tells both ends MOT to convert to network standard, but 
rather send a file 'as is'. This is included for Lisp files which 
contain internal character pointers that are messed up by removing line 
feed characters. 

Don't specify an EOL convention unless you know what you are 
doing. If your text file is a Lisp source file, specify EOL 
convention 'Transparent'. 

6.4. File Dates 

The Alto file system keeps three dates with each file; Creation, Read, 
and Write. FTP treats the read and write dates as properties 
describing the local copy of a file: when the file was last read and 
written in the local file system. FTP treats the creation date as a 
property of the file contents: when the file contents were originally 
created, not when the local copy was created. Thus when FTP makes a 
file on the local disk, the creation date is set to the creation date 
supplied by the remote FTP, the write date is set to 'now' and the read 
date is set to 'never read'. 



7'. Abort and Error messages 

Error and Abort packets are displayed in a window above the title line. 
Abort packets are fatal; Error packets are not necessarily so. 

The most common Abort message is "Timeout. Good bye", generated when a 
server process has not received any commands for a long time (typically 
5 minutes) . 

The most common Error message is "Port IQ overflow" indicating a 
momentary shortage of input buffers at the remote host. Receiving an 
Error Pup does not imply that the file in transit has been damaged. 
Loss of or damage to a file will be Indicated by an explicit message in 
the User FTP window. The next Iteration of Pup will probably rename 
'Error Pups' to be 'Information Pups'. 



8. Telnet 

FTP provides a simple User Telnet as a convenience for logging into a 
remote host (e.g., Maxc) to poke around without having to leave the FTP 
subsystem and start Chat. It lacks most of the creature comforts Chat 
provides, such as automatic attaching to detached jobs, automatic 
logging in, etc. The Telnet is not enabled when the User FTP is being 
controlled from the command- 1 ine, When the Telnet does not have an 
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open connection, It waits for you to type a host name with the syntax 
explained above for the OPEN command, and then attempts to connect to 
the specified host. If you wish to abort the connection attempt, hit 
the bottom unmarked key (opposite right-shift). You can get a larger 
Telnet window by not starting a server (type FTP/-S to the Executive). 



9. Hova FTP 

FTP is also available running under Dos Rev 4 and RDos Rev 3. Since 
the Nova versions are nearly identical to the Alto version (the same 
source files except for initialization), only the differences are 
listed here. 

1) Ignore all references to display windows. All printout goes 
to device #11, whatever that is. 

2) Ignore all references to 'unmarked keys' such as for 
aborting connection attempts and directing keyboard input to 
various windows. 

3) Lack of memory and lack of a windowing display made 
including a Telnet impractical on the Nova. 

4) The syntax of the command lino is limited to that acceptable 
to the Nova operating system. Warning: the command line 
examples given above may not all work on a Nova. 

5) The Nova OS does not maintain a username or password, so all 
interactions with a Maxc system or an IFS will require the user 
to supply them. 

6) File creation dates are not supported, so there is no Update 
option to RETRIEVE, and the LIST command does not show dates. 

9.1. FTP releases 

The Nova FTP subsystem consists of a save-file, FTP.SV, and an overlay- 
file, FTP.BB. You must get BOTH files when a new version of FTP is 
released. If you rename FTP.SV you must rename FTP.BB to have the same 
name (for instance if you rename FTP.SV to be OLDFTP.SV you must also 
rename FTP.BB to be OLOFTP.BB). New releases of FTP will be 
distributed as dump files with a consistent pair of save- and overlay- 
files. 



9.2. Device codes 

FTP assumes that Nova Ethernet interfaces have device codes 73 and 74, 
63 and 64, or 63 and 54. It will use all interfaces with these codes 
that seem (from reading some status registers) to be Ethernets. The 
Dos version of FTP assumes that Nova MCA interfaces are device code 6 
and 7, or 46 and 47. It will use all interfaces with these codes that 
seem to be MCAs. 
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9.3. ROos notes 

FTP is big, and win not run under some RDos systems. If you have 
trouble, generate a smaller system and boot from it when running FTP. 
FTP disables parts of RDos with patches which may not work for versions 
other than Rev 3. It will NOT work under an RDos that uses the memory 
map hardware. The RDos version does not include MCA drivers. 



10. Revision History 

April 1976 

First release. 

May 1976 

/Q switch adf'id to CONNECT. Connection requests to the User FTP and 
Telnet can be aborted. login prompt changed. 1 minute Timeout added 
when waiting to finish after a command line error. User FTP 
automatically recovers from more "No" responses from the remote server. 

June 1976 

Dos version roloased. DIRECTORY and LIST, commands added. Update (/U) 
option added. File creation dates added. 5 minute no-activity timeout 
added to FTP Server. FTP version, time-of-day, and machine address 
added in top window. "Ding" now flashes only the affected window 
instead of the whole display. 

August 1976 

RDos version released. Same as June release for Dos and A1to. 

October 1976 

DUMP and LOAD commands added to user FTP. KILL command added. Free 
disk page count added to the title line. Verify (/V) switch added to 
the RETRIEVE command. 

November 1976 

Bug fixes to the October release. 

May 1977 

This version was only released to friends. KILL command removed and 
turned into a server option, DEBUG command moved Into new USER and 
SERVER commands. Trident disk option (/T) added. User LIST command 
improved and Server LIST response implemented. Password checking by 
tho FTP server implemented. Telnet window enlarged at the expense of 
possibly losing Information from the top of the window if the lines are 
very full. DELETE, RENAME, and DEVICE commands implemented. Much 
internal reorganization so that the protocol modules could be used in 
IFS and released as a package. 

July 1977 
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Global switches changed. <Shift-Swat> should wonk more reliably now. 
User LIST command further Improved. Keyboard command interpreter 1s 
much more robust and consistant. Command line STORE and DUMP go much 
faster since they look up files using MDI. FTP/Tx opens Trident unit 
'x'. LOGIN command added to command line Interpreter. 

November 1977 

Special microcode added to speed up execution. 

March 1978 

User log option added (see /L and /A switches and 'FTP User Log' 
section). AllocatorDebug switch removed. New command line commands 
COMPARE, OPEN, and CLOSE added. Command line errors are handled 
differently (see /E global switch and 'Command Line Errors' section). 
When using a Trident, either a User or a Server FTP Is started but not 
both (see the section on Trident disks). 

September 1979 

This is a maintenance release coordinated with 0S17, fixing a few bugs 
and reloading with current packages. CONNECT cancels • any previous 
DIRECTORY. CLOSE cancels any previous CONNECT. DIRECTORY, DEVICE, 
TYPE, BYTE, or EOLC. Multiple logical file systems on a T-300 can now 
be addressed: Ftp/T400 opens logical fllesystem 1 on physical unit 0. 

October 1979 . 

The command line version of the OPEN command retries failed connection 
•attempts every five seconds under control of the error flag. Ftp. boot 
Is now a type B boot file. It EtherBoots faster and consumes less disk 
space In boot servers. It now works with all Alto file system 
configurations. 

June 1980 

New command line commands: LIST, LOAD/U and LOAD/S. Ftp handles file 
creation dates In dump-format files. Subcommand mode in the keyboard 
LIST command is the same as Maxc and IFS, namely one terminates the 
filename with <comma carriage-return>, and the VERBOSE option includes 
file lengths. The keyboard DIRECTORY and DEVICE commands display their 
previous values. Data transfer commands report bytes transferred and 
bits per second. The TFS option now works on Alto/Sugart systems. 



I 



7 



Printer Dover 



Spruce version U.O -■ spooler version 11,0 



File: laurelmanual.press 



Creation date: 14-Dec-79 11:49:24 PST 



For: falls 



22 total sheets = 21 pages, 1 copy. 



Problems encountered: 
mpl.: brightness, hue, 
nipl.: brightness, hue, 
mpl.: brightness, hue, 
mpl.: brightness, hue, 
mpl.: brightness, hue, 
mpl.: brightness, hue, 
mpl.: brightness, hue, 
mpl.: brightness, hue, 



Not 
Not 
Not 
Not 
Not 
Not 
Not 
Not 



saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation, 
saturation. 



show- 
show- 
show- 
show- 
show- 
show- 
show- 
show- 



object, show 
object, show 
object, show 
object, show 
object, show 
object, show 
object, show 
object, show 



-dots-opaque, 
•dots-opaque, 
■dots-opaque, 
■dots-opaque, 
■dots-opaque, 
■dots-opaque, 
■dots-opaque, 
■dots-opaque. 



dots from filesl 
dots from filesl 
dots from filcs| 
dots from files! 
dots from filcsj 
dots from filesl 
dots from files! 
dots from files] 



fteprfnted with the permission of Xerox Corporation for distribution within the Stanford 
University Department of Computer Science. Not to be rersold. duplicated, or otherwise 
distributed. 



Laurel Manual 



Table of Contents 

1. Introduction 65 

What is laurel? 
What is this manual? 

2. Basic notions and facilities 65 

How to obtain laurel 
How to run Laurel 

2.1 The user interface 66 

Command invocation 
Type-in conventions 
Brackets 

2.2 1'he display 67 

Scrolling and thumbing 
Adjusting region sizes 

2.3 Ihc tablc-of-contcnts region 68 

2.4 Ihc upper menu . 69 

Mail flics 
New mail 

2.5 The selection coinmands menu 70 

Displaying messages 

Selecting messages 

Deleting and undeleting messages 

Generating hardcopy 

2.6 Composing and delivering messages 71 

Composition 
Delivery 

2.7 The feedback region 72 

2.8 Leaving Laurel 73 

3. Additional facilities 74 

3.1 Filing and classifying messages 74 

Move to {file} 
Mark characters 

3.2 Additional editing and delivery facilities 74 

Secondary selection 
Paragraphs 
Distribution lists 
Get and Put 
Message header format 

3.3 Autlientication and logging in 77 

3.4 Polling for new mail 77 

3.5 Command line options 77 

Mail file selection 
In-box interrogiilion 
Send message mode 



© Xerox Coiporation 1979 



64 Laurel Manual 



3.6 The Laurel profile 78 

4. If things go wrong ... 80 

5. Laurel and MSG 80 

Mail flies 

Mail file philosophy 

Overwrite 

Processing your mail away from an Alto 

Moving mail files from Maxc 

6. Look before you leap ... 82 

Formatting messages for non-Laurel users 

Secondary selection from the message display region 

Tabs 

The Answer form 

File version numbers 

Space required for mail files 

Ilardcopy usage 

7. Things a casual user doesn't really need to know 83 



Laurel Manual 65 



1. Introduction 

What is Laurel? 

Laurel is an Alto-bascd, display-oriented, message manipulation system. It provides facilities that 
permit its users to display, forward, classify, file, and print messages, and to compose and transmit 
messages and repiies. Laurel is an initial component of what will ultimately be a distributed 
message system. Although Uie distributed nature of diis system has inherent technical interest, it is 
largely transparent to the users of the system, who see a collection of logical facilities resembling 
those provided by MSG on Maxc. Eventually, the services of Laurel will surpass those of MSG, but 
at present, the two are roughly equivalent in function. The important distinction for now is that 
J^urel executes on an Alto and uses the display in a fashion befitting Alto-based software. It also 
produces files that can be manipulated by other Alto subsystems. 

Many initial users of Laurel will be familiar with MSG and will naturally be interested in the 
ftmctional differences between MsG and Laurel. This manual. In addition to presenting the 
facilities of Laurel, points out some of the incompatibilities with MSG. Prospective Laurel users with 
strong ties to MSG should read section 5 carefully before committing themselves to Laurel. The 
Laurel team fully expects that some potential users will find the transition to Laurel too 
uncomfortable to undertake at present. Accordingly, we have provided a "free sample" of Laurel in 
the form of a tutorial (see section 2), which can be run without any commitment to further use of 
laurel or danger to MSG files. We would much prefer that Laurel users "go in with their eyes 
open" and not be unpleasantly surprised when confronted by incompatibilities. 

What is this manual? 

This manual is a reference document for Laurel. The Laurel team believes that most of the basic 
facilities of Laurel are self-explanatory, and that you can probably use Laurel quite competently 
after reading only the introductory sections of this manual, (lliere is also a tutorial available to 
guide new users; see section 2.) However, Laurel has features that are not immediately obvious, 
and after becoming acquainted with the system, you will want to read about these facilities. The 
Laurel team will be very happy to hear any suggestions you may have, and is particularly interested 
in your experiences in using the initial system. Comments should be sent to LaurclSupport (using 
the facilities provided by Laurel!) 

The version described in this manual is Laurel 2.0. Laurel displays its version number in the 
upper-left corner of the screen. Future versions of laurel containing major new capabilities will 
change the integer part of the version number, whereas maintenance releases will change the 
fractional part. 



2. Basic notions and facilities 

Laurel is a display-based, interactive program that manipulates a particular class of files, called mail 
fdes. In essence, a mail file is just a sequence of messages, each of which is a text string formatted 
according to certain conventions. The details of these conventions are not of major interest to most 
users— suffice it to say that messages have a header and a body; a header contains (at least) a sender, 
a subject, one or more recipients, and a date. For each mail file. Laurel constructs and maintains a 
table-of-contents that summarizes the messages residing in the file. Mail files are private to each 
user, meaning, at present, that your mail files reside on your own Alto disk(s). laurel provides 
facilities for manipulating mail files, examining and responding to messages, composing and sending 
new messages, and cataloging, filing, and printing messages. These ftmctions arc discussed below. 
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How to obtain Laurel 



We recommend strongly that new users obtain a Non-Programmer's disk to be used primarily for 
processing and managing messages (sec section 5 for the reasons behind this recommendation). ITic 
Basic Non-programmer'S Disk already has Laurel installed, so if you have obtained a copy of 
this disk (by die procedure described in the Alto Non-programmer's Guide), you may skip the next 
paragraph. 

Two Alto command files are available on most file servers for obtaining laurel. If you are a new 
user, you should issue the following commands to the Alto Executive: 
> Ftp Files erver Retrieve <Laurel>LaurelNewUser.cmCR 

> @LaurelNcwUserCR • u r i 

This obtains Laurel and starts it up in a tutorial mode. If you arc already familiar with Laurel, you 
should retrieve and execute <Laurel>Laurel.cm, which merely retrieves tlic files necessary to run 
Laurel. 

Note to Mesa programmcnf: Laurel 2.0 is a Mesa 4.1 program and therefore requires the Mesa 4.1 version of 
RunMesa.run to be on your dislc. For this reason it can't coexist on a dislc with a version of Mesa other than 4.1. 

Before using Laurel's hardcopy command for the first time, you must edit your Laurel profile (file 
Laurcl.Frofile) to declare the name of Uic printing server to which your hardcopy is to be sent. See 
section 3.6 for information on the Laurel- profile. 

How to run Laurel 

To invoke Laurel, type 

>LaurelCR 
to the Alto Executive. This is the default method of invoking Uurel. Command line options are discussed in 
section 3.5, 

To invoke tlie Laurel tutorial (after obtaining it with ©LaurelNewUser), type 
> Laurcl HelpCR 



2.1. The user interface 

Laurel is a highly interactive system in which economy and clarity of expression are essential. In 
striving to provide a convenient user interface. Laurel borrows a number of conventions familiar to 
users of other Alto subsystems. This section describes the principles that underlie the Laurel user 
interface. 

Command invocation 

Most Laurel facilities are invoked by use of the mouse, with the keyboard being used almost 
exclusively for text entry. Commands are generally represented by words or phrases on the display 
screen. You invoke a displayed command by moving the mouse until the screen cursor points at 
the desired command, tlien clicking a mouse button (usually RED). If you hold down red and 
move the cursor to point at a command, the command will appear inverted (i.e., white letters on 
black background). When you release the button, the command name will appear grayed (i.e., black 
letteVs on a gray halftone background). If, while holding down the mouse button, you change your 
mind about tlie command you intend to select, simply move the cursor until the inverted name is 
restored to its normal state, then release the button. A fme point: position the cursor so that it points at the 
command, not so thai it rests on top of it 
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Normally, you use RED to invoke commands. Some commands have such a significant effect on the 
current state that you must confirm them explicitly, and in such cases Laurel will prompt you. If 
you arc certain in advance, you may invoke the command by clicking blue. Laurel will then 
suppress the prompt for confirmation and execute the selected command immediately. 

Laurel prompts you for confirmation by displaying the message 

Type ESC to confirm, DEL to cancel command. 
in the feedback region at the bottom of the screen. It also displays a large flashing question maik 
in the cursor. You may confirm by typing ESC, CR, Y, or space, or by clicking YEl,LOW. If you 
type DEL or N, the command will be aborted. Ultra-fine point: if you change your mind after pressing 
YEl,LOW, but before releasing it, clicking RED will turn it into a DEL! 

Type-in conventions 

Laurel observes most of the standard Alto type-in conventions. When it expects you to supply text, 
it displays a blinking caret at the appropriate place on the screen. Striking BS or A*^ deletes the 
character to the left of the caret; W^ deletes die word to the left of die caret. Type-in may always 
be terminated by typing ESC; sometimes other characters will terminate input as well (see below). 
Commands that do not permit you to make a secondary selection may also be terminated by clicking YELLOW. 

Brackets 

Several Laurel commands require text arguments. In particular, commands that manipulate a file 
need to know the name of the file on which they arc to act. Text arguments appear in {brackets} 
following the command name on the screen. 

When you invoke such a command with rp.d, Laurel prompts you to fill in the brackets by 
displaying a blinking caret within the brackets, ir there is already text within the brackets, the caret follows 
the text. In addition to the type-in conventions described above, the following rules apply: If you 
type ESC, CR, TAB, or space, or click yellow, the caret disappears and the contents of the brackets 

remain unchanged, if you type BS or W*^ the contenLs of the brackets will be edited as if you had just typed that 

text. If you type anything else (except as described above), it replaces the complete text within the 
brackets. Type-in is terminated by ESC, CR, tab, space, or yellow. Typing del aborts the entire 
command. 

If you invoke the command with blue rather than red. Laurel executes the command immediately, 
using the text argument already contained within the brackets, with no further action on your part. 
This is tme of all commands that have text arguments in brackets, with the exception of the u.ser command. 



2.2. The display 

Laurel maintains four regions on the display screen. From top to bottom they are: the table-of- 
contents region, the message display region, the composition region, and the feedback region. The 
tablc-of-contents region holds a directory of the messages residing in the current mail file. The 
message display and composition regions arc used to examine messages received and to compose 
messages to be sent, respectively. The feedback region displays various information (frequently 
error notifications) appropriate to particular Laurel commands. Each region will be discussed in 
detail in subsequent sections. 

The display also has three command menus. The topmost menu, just above the tablc-of contents 
region, contains a number of miscellaneous commands and status information. The commands, like 
all commands on the Laurel screen, appear in bold-face type; the status information is in normal 
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type. We call this simply the upper mem. Iklow the table-of-contcnts region and above the 
message display region is the selection menu. The commands in this menu are used to manipulate 
selected entries in the table-of-contents. Hclpw the message display region and above the 
composition region is the composition and delivery menu. As the name implies, this menu contains 
commands that facilitate the composition of new messages and responses to old ones. The 
composition region is separated from the feedback region by a single horizontal line. 

Scrolling and thumbing 

The table-of-contcnts region, the message display region, and the composition region each have a 
scroll bar in tlie margin to tlicir extreme left. Within this scroll bar, the red and blue mouse 
button behave as they do in Bravo. The cursor will appear as a double-headed arrow when 
positioned in the scroll bar and will change to point up or down when RED or blur is pressed. 

Thumbing differs substantially from the Bravo style. At the top of each of the scrollable regions is a 
horizontal bar that separates the region from the menu above. When the cursor is positioned just 
below this bar and yeixow is depressed and held, a short vertical line segment appears on the bar. 
Moving the mouse to tlic left or right causes a corresponding movement in this line segmenL The 
position of the line segment relative to the left ed^e of the horizontal bar identifies a location within 
tlie text associated with the region. U'hus, moving the line segment to the extreme right edge of the 
bar identifies the end of the associated text; positioning it in the center of the bar specifies the 
middle of the text. When yel,low is released, the identified position is brought to the top of the 
region. 

A portion of the thumbing bar appears as a dashed line, whose position and length correspond to 
tlie text displayed in the window. Thus, positioning the line segment at the left edge of the dashed 
line identifies the beginning of the currendy displayed text. (Releasing yellow at this point 
naturally has no effect on the display.) 

As you will see shortly, it is possible to select entities within the table-of-contcnts and composition 
regions. The position of the selected entities in each region is indicated on its associated thumbing 

bar by a short vertical line segment. I'his segment is always present, and should not be confused with the line 
segment that appears when you depress YELLOW. You can therefore obtain the effect of liravo's Normalize 
command by pressing down on YELLOW and positioning the cursor so that it coincides with the 
pemiancnt segment on the thumbing bar. Releasing the mouse button tiicn causes the selected text 
to be moved to the top of the region. 

Adjusting region sizes 

Yoti can adjust the boimdaries of the three major regions using the small squares at the upper right- 
hand corner of the two lower menus. Point tlie cursor at the desired box, then press down and 
hold YELLOW. By moving the mouse tip or down, you drag the box witli you to a new position on 
tlic screen. When you release the mouse button, the menu will move to the new position, and the 
contents of the adjacent regions will be adjusted accordingly. A fine point: you may find it more 
convenient to hold down YliLLOW and move the cursor to the vicinity of the box. The box will capture the cursor 
when it comes sufficiently close. 



2.3. The tablc-of-contents region 

This region provides an index to tlie messages in the current mail file. Each entry in the index is 
numbered and contains the date sent, the sender, and the subject, it is also possible for each entry to have 

a mark diameter for classification purposes— we will discuss Ibis in section 3.]. Laurel doCS not permit yoil tO 

modify the information in the table-of-contents window (except the mark character). 
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When Laurel begins execution, it normally gets the default mail file and displays its table-of- 
contents in the top region on the screen. It also places a selection pointer (which appears as a small 
black triangle pointing to the right) next to the last entry in the index (or first unexamined entry, if there 
is one). This pointer is used to identify messages that you wish to manipulate, and can be 
repositioned with the mouse buttons. We will discuss it in detail shortly. 



2.4. The upper menu 

The upper menu contains some obvious status information: the date and time, the version of 
Laurel you are ixinning, and the amount of free space remaining on your Alto disk. Tiiere is also a 
space reserved for posting the status of your in-box— sec section 3.4. Of tlie remaining items, which are all 
commands, we discuss only Mail file and New mail here. The other commands are documented in 
sections 2.8 and 3.3. 

Mail files 

Laurel maintains one or more mail files for you. You should think of mail files as folders ir^ which 
you organize the messages you receive. When Laurel is first started, it normally checks to sec if 
you have a file folder labelled "Active.mail", and if not, it .creates an empty file and labels it for 
you. This file is called your default mail file and is generally used to contain new messages that you 
have not yet processed. You will see how additional mail files are created in section 3.1. 

To direct Laurel's attention to a mail file other than the current one, proceed as follows. Point the 
cursor at Mail file in the upper menu and click ri-d. A blinking caret will appear in the brackets 
following the command, inviting you to type the name of the file you wish to examine. (See the 
description of {brackets} in section 2.1.) After you have supplied the file name, Laurel will fill the 
tablc-of-contents region with the entries from the designated file. You can then use the facilities 
described in subsequent sections to manipulate this file. 

Mail file {file} always reads from the file whose name is displayed in the brackets. However, it 
observes two conventions that simplify type-in. First, if the displayed name does not contain a 
period. Laurel implicidy appends ".mail" to the displayed name before accessing the file. Second, if 
Mail file is invoked witii BLUE rather than RED, Laurel omits the prompt for a file name and uses 
the name currently displayed. 

A fine point: Laurel acts on deletions (see section 2.5) whenever cither Mail file or Quit is selected. Thus, you cannot 
Undelete messages in a mail file once you have switched Laurel's attention to a different file. 

New mail 

Messages that are waiting for you reside in your in-box. The in-box is also called the mail box. but wc will 
avoid this term lo prevent possible confusion with mail file. You instruct Laurel to move the contents of your 
in-box to your current mail file by pointing the cursor at the New mail command in the upper 
menu and clicking ri:d. The command will then appear on a gray background and the cursor will 
assume the shape of an hour-glass, confinning that Laurel is busy shuffling messages. You will also 
observe the free page counter changing. When all messages have been transferred, the gray background 
and hour-glass will disappear, and the table-of-contents window will be updated to reflect the new 
messages placed in your mail file. Transferring the contents of your in-box to your mail file renders 
the in-box empty. 

As the New mail command is completed, the table-of-contents region is scrolled so that as much as 
possible of the new mail is displayed, and tlic selection pointer is set to point at tlic first new 
message. You will also observe that each new entry has a "?" to its left— this indicates that the 
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contents of the associated message have not yet been examined. ITie "?" is a mark character, you 
can change it to provide a (primitive) classification of the message— see section 3.1. 



2.5, The selection commands menu 

Displaying messages 

Nomially, to examine the contents of a message, you must first select its table-of-contents entry with 
the selection pointer (see below). However, after obtaining new mail from your in-box. Laurel 
automatically selects the fii-st new message for you. To display a selected message, simply point the 
cursor at the Display command in the selection commands menu and click rf.d. The selected 
message will then appear in the display region just below tlie menu. You may scroll the niessage or 
adjust the boundaries of the region for more convenient reading. 

To examine the next message listed in the table-of-contents, click Display again. The selection 
pointer will be moved to the next entry, and the text of die message will be displayed. Thus, 
although Laurel permits you to move the selection pointer explicitly (see below), you need not do 
so. Simply click Display repeatedly and Laurel will advance the selection pointer by one entry each 
time. 

A fine point; Laurel will skip over deleted messages (sec below) when advancing the selection pointer. To dispby a 
deleted message, you must select it explicitly, then click Display. 

Selecting messages 

Entries in the table-of-contents region are selected in the same way tliat lines of text are selected in 
Rravo. Position the cursor to the right of the scroll bar next to the entry you wish to select. The 
cursor will appear as a right-pointing arrow when it is properly positioned to change the selection 
pointer. Click RF.D. The selection pointer will move to the indicated entry. By performing explicit 
selections, you may examine the contents of your mail file in any order you wish. 

More generally, you can select any consecutive group of entries in the table-of-contcnts. This is not 
particularly useful if you only wish to display messages, but can be convenient if you wish to delete 
a group of messages (see below), move a group of incssages to another file (section 3.1), or generate 
hardcopy (below). You first select a single message, as described above, then extend the selected 
range by moving the cursor either up or down and clicking blue. Thus, selections are made with 
RED and BLUE in much the same way they are in Bravo. yeliX)W has no effect. 

Deleting and undeleting messages 

After examining some of the messages in your mail file, you may wish to delete them. The Delete 
command, when activated by pointing the cursor at it and clicking RED, will cause a line to be 
drawn through all selected- entries in the table-of-contents. You tnay find it convenient to use 
Display and Delete alternately when processing newly-arrived junk mail. 

If you discover that you have inadvertently deleted some messages that you want to keep, simply 
reselect them if necessary, position the cursor over Undelete, and click red. The lines drawn 
through the table-of-contents entries of the selected messages will be removed. 

Deleted messages are expunged (i.e., removed permanently) from the current mail file whenever a 
Quit (see section 2.8) or Mail file command is executed. 
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Generating hardcopy 

To print a copy of one or more messages in your mail file, select the message or messages in the 
table-of-contcnts, point at Hardcopy, and click RED. Laurel will generate hardcopy of each message 
in the form of an inter-office memorandum, one page (or more if necessary) per message, and send 
it to be printed on your default printing server. Messages that have been deleted (i.e., whose tablc-of-contents 
entries have lines through them) will not be printed, even if they arc selected. 

There are no options that you can exercise at the time you issue the Ilnrdcopy command. However, by changing your 
Ixiurel profile, you can control certain aspects of the hardcopy formatting as well as a few olher things such as the name 
of your printing server (see section 3.6). 



2.6. Composing and delivering messages 

Composition is the process of btiilding the header and body (see the beginning of section 2) of a 
particular message. Delivery is the process of transmitting a composed message to its specified 
recipients. Laurel separates these two actions and supplies distinct commands appropriate to each in 
the composition and delivery menu. 

Laurel provides four ways to initialize the content of a message. You may compose a new message, 
or answer one you have received, or forward an existing one to a new recipient, or get a previously- 
composed form or message from a file on your Alto disk. In the composition and delivery menu 
(below the message display region), there are four commands corresponding to these actions: New 
form, Answer, Forward, and Get. Simply select the one you wish by positioning the cursor 

appropriately and clicking Rf'-D. if the composition region contains an undelivered message, these commands 
request confirmation before constructing a new form. As in olher such contexts, selecting these commands with BLUE 
automatically supplies confirmation. Even after confirmation. Undo (sec below) can slili be used to recover the previous 
contents of the region. 

It is important to understand that New form, Answer, and Forward only provide a message ybmi; 
you must edit the form before requesting that it be delivered. Get will be described in more detail 
later (section 3.2). 

Composition 

New form gives you a new message form in the coinposition region. The form contains "To", 
"Subject", and "cc" fields, which you should fill in as appropriate. Laurel provides a subset of 
Bravo's editing commands to permit you to compose these fields and the message body. Laurel 
provides tlie Append, Delete, ]nsert. Replace, ESC (repeat) Undo, and secondary selection functions 
of Bravo, but does not handle italics, bold-face, multiple fonts, or any "looks". For important addiUonal 
editing functions, see section 3.2. In short, the message you compose is simply an unformatted text string. 
However, r,aurcl does supply automatic line breaks as Bravo does, so you need not type CRs except 
to produce white space. 

At present, the laurel editor is not quite compatible with Bravo, though it may be in the future. In particular, you 
should be aware of the following differences. An Undo will undo the previous command. Undo always undoes the 
previous command exactly where it was given. To move text from one place to another use Delete followed by Insert 
ESC. New forin. Answer, l<"orwar(l, and Get may also be undone. 

In general. Laurel imposes format restrictions only on the inessage header. By definition, the header 
ends at the first blank line (i.e., two successive CRs). You should therefore be careful not to delete 
the blank line provided by Laurel in each of the three initial forms. The header itself consists of a 
sequence of fields, some of which are required to be present. When composing a message you 
should always fill in the "To" field and the "Subject" field; you may delete the "cc" field if it is not 
needed. When the message is ultimately delivered (see below), Laurel will supply your name and 
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the date, so you need not include them explicitly. 

Answer and Forward initialize a message form in different ways, but both take information from the 
message currently displayed in the message display region (which is not necessarily the one selected in the 
lablc-of-contents region). Answer fills in the "To" field with the sender of the currently displayed 
message and sets the subject to be "Re: sender's subject". It also sets the "cc" field to include all of 
Uic recipients of die message being answered. If you don't liice these substitutions, you may, of 
course, change them using tlic editing facilities. Forn..rd copies the message body from the display 
region into the composition region. After clicking either Answer or Forward, you must complete the 
message by editing any remaining uninitialized fields in the message header and body. 

Laurel identifies fields that it expects you to replace by supplying a keyword bracketed by black 
rectangles, e.g., IRccipientsl. Laurel will refuse to deliver any message whose header contains one 
of these fields. This protects you from simple oversights, such as forgetting to supply a "Subject" 
field. 

Delivery 

Once you have composed the message you wish to transmit, you may initiate its delivery to the 
recipients by pointing the cursor at Deliver and cHcking rhd. Laurel will fill in your name and the 
date (though they won't appear in the composition region) and proceed to send the message. A 
gray background will appear behind the Deliver command and the cursor will change to an hour- 
glass, if Laurel discovers an error in the list of recipients, it will give you an opportunity to cancel 
the delivery and correct the mistake. When tlic list is acceptable (i.e., all spcciricd recipients are known to 
have in-boxcs). Laurel will deliver the message and remove the hour-glass and gray background. 
After successful delivery, the word Deliver will disappear and will be replaced by "delivered'. If an 
error occurs during delivery, an explanation of the error condition will be displayed in the feedback 
region. You may cancel delivery while the message "Type DEL if you wish to cancel delivery" 
appears in the feedback region. 

Before filling in your name in a composed message, I.aurel will check to see if the message header already contains a 
"From" field, if so, l.aurel inserts a "Sender" field with your name and leaves the "From" field untouched. It is the 
"From" field that is normally displayed in the table-of-contents. The name Laurel furnishes is your logged-in user 
name — see section 3.3. 

Oelivcr tells you the number of recipients to whom it will deliver the message. If this number exceeds 30, you must 
confimi ihe delivery. This is intended to minimize unintentional deliveries to large distribution lists. Deliver also tells 
you the size of the message (in characters). 



2.7 The feedback region 

laurel uses the feedback region for three classes of information: status reports, exceptions, and 
confirmation requests. Status reports are displayed by various commands, e.g., Deliver, to report 
circumstances of interest to you but which require no direct action on your part. Exceptions are 
notifications of errors committed by you (or Laurel) and are fiashcd to alert you that some 
corrective action is probably required. Confirmation requests (see section 2.1) flash both the 
feedback region and a "?" in the cursor, alerting you to the need for immediate action before 
Laurel can continue. 
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2.8 Lcnring Laurel 

To exit from Laurel and return to the Alto Executive, point the cursor at Quit (in the upper menu) 
and click RRD. Laurel will prompt you for confirmation. After you confirm. Laurel will act on the 
deletions indicated in the table-of-contenLs region, eliminating all messages from the mail file that 
have lines drawn through their table-of-contcnts entries. If you invoke Quit with BLur;, Laurel will 
omit the confimation prompt. When you re-enter Laurel at a later point, these messages will no 
longer appear in the table-of-contents. They arc gone forever. 

Leaving Laurel by any means other than Quit is not recommended and will slow down subsequent 
re-entry to Laurel. 
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3. Additional facilities 



3.1. Filing and classifying messages 

[.aurcl provides two facilities to assist you in classifying your mail. Remember that your default 
mail flic should be viewed as holding those messages upon which you have yet to act. Naturally, 
you may want to file away those messages on which you have already acted. The command Move 
to {file} in the selection menu allows you to do this. Mark characters provide a simple means of 
attaching labels to individual messages within a mail file. 

Move to {file} 

To invoke Move to {Jile} proceed as follows. First, select (wiUi selection pointers — sec section 2.5) 
the messages you wish to transfer to a separate file. Next, point the cursor at Move to and proceed 
as you would for Mail file (see sections 2.1 and 2.4). After you have supplied the file name, Laurel 
will append the selected messages to the indicated file. Laurel will draw a line through the table-of- 
contents entries of the messages that have been iiioved so tliat the corresponding messages will be 
deleted when you leave Laurel (or change mail files). If you wish to retain any of these messages in 
the current mail file as well, you may use "Undelete" as described above. Laurel will also mark (in 
the mark character field — see below) moved messages with an "m". 

Move to does not move any messages that are indicated as deleted. If a range of messages 
containing both deleted and non-deleted messages is selected for Move to, only the non-deleted 
messages are moved. 

Move to observes the same type-in conventions that Mail file does. It also implements one other 
convention that guards against misspelled file names: if the displayed file name does not 
correspond to any existing file. Laurel prompts you for additional confirmation before creating and 
writing a new file with that name. 

Mark characters 

You may wish to classify messages within a particular file. Laurel provides a primitive marking 
system by allowing you to supply a single mark character for any table-of-contents entry. To set the 
mark character, position the cursor to the left of the desired entry but to the right of the line bar 
and selection pointers. Click RED. A blinking caret will appear, inviting you to type a single 
character. This character will be retained in the table-of-contents entry and displayed whenever the 
entry is in the region. It will also be retained in the message if it is moved to another file (using 
Move to {Jlle}). Note that "?" and "m" are valid mark characters but have additional semantics assigned to them by 
Laurel. Other mark Characters may be assigned special meanings in the future, e.g., to pennit selective display of the 
table-of-contents. You may change the mark character by positioning the cursor over the mark to be 
changed and repeating the preceding steps. A space is a valid mark character. 



3.2. Additional editing and delivery facilities 

Secondary selection 

Laurel supports secondary selection (for Insert, Append, and Replace commands) in the same 
manner as Bravo docs. That is, you may identify the text string to be inserted by using the mouse 
buttons to select characters, words, lines, or paragraphs. You may select text in either the message 
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display region or the composition region, and you may scroll or thumb within cither region while 
making the secondary selection. 

Paragraphs 

Although Laurel docs not implement Bravo's notion of paragraphs, it does provide a selection mode 
that gives similar results in simple cases. Laurel defines a paragraph terminator to be two successive 
CRs. You may select a paragraph by positioning the cursor in the line bar to the left of the desired 
text and clicking yellow, just as in Bravo. The main visible difference is that Laurel will not 
display Bravo's paragraph symbol in the cursor. 

Distribution lists 

Suppose you have a collection of people to whom you frequently send messages. To avoid having 
to type the entire list of names every time you send a message to tlie group, you may proceed as. 
follows. Create an Alto file containing the list of names (separated by commas, no CR at the end). 
You may find it convenient to "label" such distribution lists; you may do so by prefixing the list with Identifying text 
followed by a colon, and then terminating the entire list with a "matching" semicolon. For example, sue': a file 
might contain 

Alpha users: Brown, Doe, Jones, Smith; 
Name this file "AlphaUsers.dl". 

Now, when composing a message in Laurel, insert the file name in the appropriate field of the 
message header (e.g., following "To" or "cc"), followed by an up-arrow character: 

To: AlphaUserst 
While delivering the message. Laurel will read the file to determine the recipients. Multiple 
distribution list specifiers may be used within a single field and may be intermixed with names of 
individual recipients— separate them all with commas. If you give your distribution list files the 
extension ".dl", you may omit typing the ".dl" to Laurel. 

You need not worry about a recipient appearing in more than one distribution list. laurel will 
detect duplicate names among the recipients and ensure that each receives die message only once. 
Thus, you may use multiple distribution list specifiers freely within the "To" and "cc" fields of die 
message header. 

The present distribution list mechanism is a temporary one, and has some inconvenient aspects. In particular, since 
distribution lists are presently stored on your own Alto's disk, they can get out-of-date rather easily. Commonly-used 
distribution lists are maintained centrally, presently as files <Secretary>*.dl on Maxc. We have tried to streamline the 
task of keeping distribution lisLs current by providing a command file, DLUpdate.cm, which updates local distribution 
lists from the central source. Registered Laurel users (i.e., those listed in LaurelUsers.dl) are notified when DLUpdate.cm 
should bo mn. DLUpdate.cm is automatically retrieved by I^urcl.cm and LaurelNewUser.cm (see section 2). Note that 
DLUpdatccm updates only those distribution lists that you already have on your disk. To obtain a copy of a distribution 
list you don't already have you must use r'FP to retrieve it from the <Secretary> directory on Maxc. Thereafter, running 
DLUpdatccm will keep it up-to-date along with all the others. 

Get and Put 

The composition and delivery menu includes die commands Get, Put {file} for filing and retrieving 
die contents of the composidon window. Put writes out the entire contents of the composition 
window onto the file whose name is inside the brackets. (If a file wiUi tliat name already exists, 
Laurel requires an extra confinnation before overwriting it.) Get replaces the contents of the 
composition window with the text contained in the file. As usual, if you click red over Get or Put, 
a blinking caret appears within the brackets and you may fill in or edit die file name before 
confii-ming the command, whereas if you click BLUE, Laure! will execute the command immediately 
using whatever name is already inside the brackets. 
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Put is useful when you want to save a partially-composed message to be completed and delivered 
later. You may also want to do this if you encounter persistent network or mail server problems upon attempting to 
Deliver. Get is also handy for obtaining custom forms (or form letters) that you have prepared 
previously. Obviously, you can use Laurel to edit arbitrary text docimicnts in much the same 
fashion as Bravo; however, since Laurel does not provide any of Biavo's formatting capabilities 
(multiple fonts, looks, etc.), you will find Laurel to be of limited utility in this respect. 

In addition to the Get and Put menu commands just described, there exist Get and Put keyboard 
commands. These work somewhat differently from the menu commands. In particular, whereas the 
Get and Put menu commands operate on the entire composition window, the Get and Put keyboard 
commands operate only on tlie current selection. Get and Put do, however, make use of liie file 
name contained in the Get, Put {file} menu command. 

The Put keyboard command first prompts you either to confirm tlie file name already in the 
brackets or to type in a new file name, then writes a copy of the currently selected text onto the file 
by that name. This text is not removed from the composition window. 

When you issue the Get keyboard command. Laurel first puts a copy of the currently selected text 
into the file name brackets. You may now either confirm that file name (with ESC or whatever) or 
type some other name followed by ESC. Laurel then replaces the currently selected text by the 
contents of the file, leaving the replacement text selected. 

The Get keyboard command can be used as a file substitution device anywhere within a composed 
message. To include the contents of a file within a message, insert tlie file name (including the 
extension) at the desired point. Then select the file name with the mouse buttons as you would for 
a Replace command, but type Get ESC instead of Replace. Laurel will replace the file name with 
the contents of that file. 

It is sometimes useful to expand a distribution list before sending a message. You can do this by inserting the 
distribution list name in the appropriate header field, selecting it, then typing Gel. In addition, there is a short-cut that 
permits you to omit the explicit ".dl" extension. If you type the file name followed by a "t", select it, and type Get, 
laurel will append the ".dl" (if no extension is present) and perform the Get. You may take advantage of this feature 
to peck at the contents of a distribution list: use Get as just described, then undo the expansion by typing Undo. 

I'lit produces a file that can be read and manipulated by Bravo. In fact, you can create a Bravo document, use the Get 
keyboard command to read it into a composed message, then send the message. The recipient can perform a forward to 
move tlie received message into the composition window, select the portion of the message consisting of the Bravo 
document, and i.ssuc the Put keyboard command to write it onto a file. It should be noted that Bravo formatting 
information in the document may contain unprintable characters, which are displayed by L-aurel as black rectangles. 
However, laurel docs not actually alter these characters, so formatting information is not lost. You must take care to 
Put the entire Bravo document (and nothing else), or else Bravo won't be able to read it 

Message header format 

Laurel supports a subset of the Arpa standard for message headers (RFC 733/Nic 41952). Happily, 
users need not be aware of most of the requirements of this extensive standard. However, two 
features should be noted. First, comments may be included in a header item by surrounding them 
with parentheses. Second,, recipients at Arpanet sites other tiian Parc-Maxc may be specified as 
either "name @ site" or "name at site". 

You should avoid typing extra CRs in message headers, since the arpa standard specifics some less- 
than-obvious behavior in such cases. In practice, this is rarely a problem, because Laurel will 
supply line breaks for you (both on the screen and in the transmitted message). 
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3.3. Authentication and logging In 

In order to perform New mail, you must be an authenticated user. This means your name and 
password must be accepted by a centralized authentlcator (currently Maxc). When you start up Laurel, 
it obtains your name and password from the Alto Operating System and submits them to the 
authentlcator for verification. If the authentication fails, the message "Name or password invalid" 
will appear in tlie upper menu, just below the Laurel version number. Laurel will not allow you to 
receive messages until you have been authenticated successfully. 

To enter a new name and password, point the cursor at User in the upper menu and click red. 
Laurel will invite you to supply a user name in the brackets following User. Respond as you would 
for other {brackets} prompts (see section 2.1). After you have entered your user name. Laurel will 
prompt you for a password in a similar way. You must supply the password explicitly— E&C, 
YELLOW, etc. cause a null password to be entered. Laurel will not display your password as you 
type it. A fine point: At present, the name you supply to the User command is used as the directory on Maxc where 
your mailbox is located. This may not be true in the future, but it will always be possible for Laurel to locate your 
mailbox from the user name you supply. 

Laurel normally requires that you be an authenticated user before it will allow you to receive or 
send messages. If, Ibr some reason, you are not an authenticated user and you select Deliver, 
Laurel will prompt you for confirmation. If you confirm. Laurel will append the phrase "(not 
authenticated)" to the sender identification it includes in the outgoing message. This makes it 
difficult for others to masquerade as you (or vice-versa). 

When you leave Laurel, your name and password are passed back to the Alto Operadng System. 



3.4. Polling for new mail 

Laurel checks your in-box periodically to determine if new mail has arrived. If it finds messages 
waiting in your in-box, it stops polling and displays "You have new mail" below the Laurel version 
number at the left-hand side of the upper menu. You niay then use the New mail command (see 
section 2.4) to move the messages in your in-box to the current mail file. After you have done so. 
Laurel will remove the "You have new mail" message and resume its periodic polling. 

Because this polling is completely automatic, you can leave your Alto running Laurel when you are 
not using it for other things, and glance at the screen occasionally to see if new messages have 
arrived. The polling interval at present is about 5 minutes. 



3.5. Command line options 

Laurel has several command line options that can be specified when you invoke it from the Alto 
Executive. 

Mail file selection 

laurel's default action, triggered when you type 

>LaurelCR 
is to perform an implicit Mail file on Activcmail. If you . type 

> Laurel /?/eHawcCR 
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Laurel will read ftlename.maW instead. If you supply an explicit extension, Laurel will respect it, 
otherwise it will use ".mail". 

In-box interrogation 

You can also request that Laurel access your in-box automatically when it begins execution. Type 

> Laurcl/nCR or > Laurel/n fileuumeCK 

Laurel will first perform an implicit Mail file on the indicated or defaulted file (see above). It then 
will check to see if messages are present in your in-box. If so. Laurel performs an implicit New 
mail. Upon the completion of the New mail (if any). Laurel is available for normal use. 

You may also invoke Laurel by 

> Laurel/cCR or > Laurcl/c filenameCR 

If messages are present in your in-box. Laurel will behave as though "/n" were specified. If no 
new mail exists. Laurel will omit the implicit Mail file and return directly to the Alto Executive. A 
fine point: if Laurel is unable to determine whether your in-box has messages, it ignores the /c switch. 

Send message mode 

If you merely want to send a message, you may request that Laurel omit its implicit Mail file when 
it begins execution. Type 

> Laurel/sCR 
Instead of reading a mail file, Laurel will perform an implicit New form as it starts up. You may 
then compose and deliver your message in the usual way. If, after doing so, you wish to process a 
mail file, simply invoke Mail file and supply a file name as described in section 2.4. 



3.6. The Laurel profile 

laurel obtains certain configuration information and options from your Laurel profile, contained in 
file Laurcl.Profilc on your Alto disk. A standard Laurel profile is installed when you obtain Laurel 
using the LaurelNewUscr.cm or I^urel.cm command file (section 2). TTie only things in the Laurel 
profile you are likely to want to change at present are tlie name of your printing serVer and perhaps 
some of tlie hardcopy format options. For completeness, however, nearly all possible options are 
documented here. 

LaureLProfile is a text file containing a sequence of parameter tines, each of which has the following 
form: 

name: value^^ 
All lines in the file must adhere to this format. This implies that there may not be any blank lines 
in tlie file. Furthermore, the last character in the file must be the CR of the last parameter line. 
Bravo formatting is not permitted. You should probably use only I,aurcl to edit Laurel.Profilc. Note, however, 
that \a\ukI configures itself according to laurel. Profile when it is started up, so after editing I.aurcl.l'rofilc you must Quit 
and restart I.aiirel before the changes will take effect. 'I'hc laurel program processes this file very quickly, with only 
minimal error checking. If l.aurcl.l'rofile is not properly formatted, the only indication from Laurel will be the exception 
message "The file laurel.profile is missing or bad." 

The value may be preceded by any number of blanks and begins at the first non-blank character. 
Subsequent characters may be blank and are included in the value. The value is terminated by the 
CR at the end of the parameter line. 

A typical LaureLProfile for use at Pare might be as follows: 
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Send: Maxc 
Retrieve: Maxc 
Authenticate: Maxc 
Hardcopy: Clover 
PrintedBy: $ 

Parameter names may be spelled in upper or lower case or in any combination. This example 
leaves out many possible parameter lines. Parainctcrs that are missing from Laurel. Profile are givc:i 
default values by Laurel. 

Send: host name 

The name or network address of the mailbox server machine to which you will send all outgoing 
mail. (Default: Maxc) Network address constants of the form number^ number^ must be used at sites where there 
is no gateway providing name lookup services. 

Retrieve: host name 

The name or network address of the mailbox server machine from which you will retrieve new mail. 
(Default: Maxc) 

Authenticate: host name 

The name or network address of your authentication server, i.e., the machine that verifies user name 
and password combinations. (Default: Maxc) Normally the values specified for Send, Retrieve, 
and Authenticate will all be the same. 

Hardcopy: host name 

The name or network address of the hardcopy server machine to which all hardcopies will be sent. 
(Default: an illegal server name) 

PrintedBy: text 

A line of text that will be printed on hardcopy break pages to identify the person making the 
hardcopy. Any "$" characters will be expanded to your loggcd-in name at the time you generate 
tlie hardcopy, (Default: $) 

Herald: text 

A line of text to be printed at the top of the first page of each hardcopicd message. (Default: Inter- 
Office Memorandum). You should take care to ensure that the herald will fit on one line when 
hardcopied. 

HeraldFont: font 

The font that will be used to print the herald on hardcopied messages. A font value must take the 
form: 

family-name point-size face 
Hxamplcs: 

TimesRoman 14 B 

Helvetica 10 
The optional B or I following the point size indicates bold or italic face. If the CR immediately 
follows the point size, the regular face is used. (Default: TimesRoman 12 B) 
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Logo: texl 

A line of text to be printed at the logo position between the header and the message body on the 
first page of each hardcopied message. (Default: XEROX). You should take care to ensure that 
the logo will fit on one line when hardcopied. 

LogoFont: font 

The font that vvill be used to print the logo on hardcopied messages. The format for the font value 
is given above under HeraldFont. (Default: Logo 24) 



4. If things go wrong ... 

In Laurel, as in most interactive systems, lots of things can go wrong. Also as in most systems, 
some of them are your fault and some of them are not. Laurel tries to prevent you from wreaking, 
destruction upon your environment, and reports any (perceived) violations in the feedback region. 

Tlic error reports in tlie feedback region are intended to be self-explanatory. If you cannot figure 
out what one means or what to do next, please send a message to LaurelSupport (using Laurel if 
possible). 

If Uuircl detects certain internal error conditions, it interrupts whatever command was in progress and posts a message in 
the feedback region. In some cases. Laurel may decide that the error should be reported to LaurelSupport, and, in such 
cases, it will prepare an error report form (after confirmation from you). This form contains internal status information 
of interest to the I.aurel implcmentcrs and should be used whenever possible. If you confirm the use of this form, 
Laurel will restart itself and display the form in the composition region. You should then follow the instractions contain 
within the form, after which Laurel will again be available for normal use. 



5. Laurel and MSG 

'ITiis section addresses the relationship between MSG and Laurel. As mentioned in section 1, MSG 
users must thoroughly understand the contents of this section before trying to use Laurel for the first 
time. If you don't use Maxc or you have never used MSG, you may skip this section entirely. 

Before proceeding to the gory details, we should remind you that these comments apply only to 
Laurel versions 1 and 2. Most of the difficulties described below are artifacts of a temporary 
implementation of a number of Laurel facilities. Future releases will cure these ills, so if Laurel 
appears insufficient for your present needs, don't give up. 

Mail files 

Laurel keeps nearly all of its files on your Alto disk. The only exception is your in-box, which is 
currently file Messagc.txt in your directory on Maxc. Getting new mail (with Laurel) moves 
messages from Maxc to your Alto disk, emptying MessageAxt. This makes it very inconvenient to 
continue to use both Laurel and MSG, and it makes Laurel inconvenient to use if you switch Alto 
disks frequently. For now, our best advice is to designate a disk on which you will use Laurel 
exclusively, and stick to it. You will need about 500 disk pages to hold Laurel (including 
RunMesa.run), a moderate-sized mail file, and several distribution lists. 

Once you have mail files on your Alto disk, it becomes impossible to process them using MSG, 
since they are on the Alto. Furtlicrmorc, MSG and Laurel maintain mail files in formats that are 
incompatible. You can continue to. use MSG to maintain mail files on Maxc, and you can use 
Laurel to maintain mail files on your Alto, but you cannot move mail files back and forth. If you 
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are willing to convert completely to Laurel, you can move MSG-constaictcd mail files to your Alto 
for use by Laurel, as explained below. However, this is a one-way street; once on your Alto the files 
cannot conveniently be moved back to Maxc and processed by MSG. If you are not willing to convert 
completely, we recommend that you wait to use Laurel until it is able to deal with remotely-stored 
mail files. 

On the positive side, your correspondents never need to know that you have converted to Laurel 
suicc Laurel is able to process your Message.txt file directly. All that has happened is that you have 
started usmg that file in a different way (as your in-box), but the change is invisible to people who 
send you messages. 

Mail file philosophy 

Laurel encourages you to use your default mail file (Active.mail) as a temporary storage area, not an 
archive. Accordingly, deleted messages are expunged whenever you leave Laurel or shift your 
attention to another mail file. There is no analogue of MSG's Quit command (which preserves 
deleted messages); Laurel's Quit is like MsG's Exit. If you wish to classify messages, use mark 
characters (section 3.1). Eventually, selective display on the basis of mark characters may be 
possible. Use separate mail files to obtain an archive facility. Laurel's performance will bo better 
and your screen will be less cluttered. 

Overwrite 

Laurel doesn't have a command corresponding to MSG's Overwrite. However, tlie same effect can 
be obtained by selecting IVTail file with blue. After you have read sections 2.4 and 2.5 it should be 
evident to you why this wprks. 

Processing your mail away from an Alto 

You can use MSG from any reasonable terminal dialed to Maxc or connected to the Arpanet but 
you can't use Laurel without an Alto. Consequently, if you have no Alto available and would like 
to process your mail, you must use MSG. If you observe a few conventions while using MSG you 
will not need to reprocess your old messages with Laurel. Thus, you can use MSG from a home 
terminal or when you are out-of-town, and revert to Laurel when your Alto is again at hand. 

As long as you manipulate only your Message.txt file with MsG, Laurel will note what you have 
done when you perform a New mail command. (Remember, Laurel uses Message.txt as your in- 
box.) Specifically, deleted messages in Message.txt will appear witli lines through them (i.e., marked 
as deleted), and tlie examined/unexamined status of each message will be reflected in the mark field 
in Laurel's table-of-contents entry. 

Moving mail files from Maxc 

Because MSG and Laurel have incompatible mail file formats, you cannot simply move your 
archival mail files to your Alto disk and expect Laurel to read them. The following (admittedly 
tedious) procedure should be followed for each mail file: 

1. On Maxc, append the desired mail file, say Archive.txt, to Message.txt: 

@ Appcnd. Archive.txt Mcssage.txtCR 

2. On the Alto, in Laurel, click red over Mail file and supply the file name "Archive". 
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3. Select New mail. After the messages have arrived, ensure that no unexpected ones have 
been included at the beginning and/or end of the file. (New mail might have arrived 
on Maxc before or after step 1.) Move any extraneous messages to "Activc.mail". 

4. Quit Laurel and go back to Maxc for the next file. You may delete Archive.txt on 
Maxc at this point. 

Fortunately, once you have moved all of your files in this way, you won't have to do it again, .iincc 
Laurel will maintain them in its own format on your Alto disk. 



6. Look before you leap . . . 

As you become familiar with Laurel, you will doubtless discover features that please you and 
"features" that annoy you. This section reports some of the annoying "features" other users have 
encountered and, in some cases, what to do to get around them. 

Formatting messages for non-Laurel users 

Laurel breaks lines in a transmitted message by a rather simple-minded algorithm. This may lead 
to line overflow when the message is read on certain terminals using MSG (or otlier mail systems). 
If you know that some of your recipients have this problem, you may wish to exercise care in the 
formatting of your outgoing messages. Use explicit CRS and keep your lines down to about 80% of 
the l-aurcl screen width. (A relatively painless way to do this is to compose the entire message 
without using CRs, then just before delivery make a final pass over the message, substituting CRs for 
spaces at appropriate points.) 

Secondary selection from the message display region 

Text in the message display region generally has real CRs in it. Laurel respects this formatting 
information, even when displayed text is copied into a composed message. If you don't like what 
you get when you insert text from a displayed message, you will have to replace explicit CRs by 
spaces before Laurel will refoiinat the text. 

Tabs 

Laurel does not prcsendy implement true tabs. Instead, a tab is converted to a fixed amount of 
white space. ^ITius, if you use tabs only at the beginning of a line, things will line up. In other 
cases, you are out of luck. 

The Answer form 

The form provided by the "Answer command is not always exactly what you might want. Laurel 
takes the viewpoint that it is easier to delete than to add text, and tiicrcfore includes all the 
information that seems to be relevant. For example, Laurel often includes your name in the "cc" 
field of the answer form, even though you may not want a copy of the message you are composing. 
You should not expect that the answer form will be exactly right; always examine tlie header to be 
certain it contains the desired infoimation. 

In particular, if you reply to a message that was directed to a distribution list, the Answer command 
will copy the distribution list specifier into tlie "cc" field of the answer form. You should consider 
carefully whether or not it is appropriate for your reply to be sent to that distribution list, and if not 
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delete the distribution list specifier. 

File version numbers 

Laurel does not support the use of Alto file version numbers. This restriction stems fi-om the 
underlying implementation of die Mesa run-time system, and is not likely to change. Therefore, 
mail files and ditribution lists should not have version numbers. 

Space required for mail files 

Some users, when converting from MSG to Laurel, have had a rude shock when they transferred 
their archival mail files from Maxc to dieir Alto disk. Recall that one Maxc disk page becomes four 
Alto disk pages when a file is moved. This is another reason for dedicating an Alto disk to mail 
processing and filing, particularly if you maintain archival mail files. 

Hardcopy usage' 

I^aurefs Hardcopy command is intended for use in printing copies of isolated messages that you 
may wish, for whatever reason, to obtain in hardcopy fonn. It is not suitable for obtaining 
hardcopy archives of all your messages, say, to put in your filing cabinet Because Laurel prints 
each message on a separate page, using Laurel hardcopy for such archival purposes would produce 
unwieldy quantities of paper. 

If you do wish to maintain a hardcopy archive, we recommend that you use the EmPress subsystem 
to print your mail file as continuous, unformatted text. 



7. Things a casual user doesn't really need to know 

Laurel currently executes almost exclusively on your local Alto. Eventually, a large fraction of its 
facilities will be provided remotely in a transparent fashion, but for now everything except in-box 
storage is local. This means that all mail files reside on the local Alto disk. For each mail file x. 
Laurel creates a separate file ;c-dms'ioc, which holds various internal information about the tablc-of- 
contents. Wiicn you invoke Mail file {x}. Laurel will recreate this file if necessary. Naturally, this 
slows down the Mail file command. 

Laurel creates scratch files while it is working and leaves them on your Alto disk. You may delete 
these files (named dms-«.'I'MP for various values of n) if necessary, though Laurel ensures that they 
will not grow very large. Deleting them lengthens the time required to start up Laurel. 

If Laurel generates an automatic error report directed to LaurelSupport (see section 4), it will leave 
behind a file Laurel.BugReport$ containing the text of that report. You may delete this file if you 
wish. 

In-boxes arc not stored locally. Laurel assumes that your in-box resides on the server machine 
indicated in the "Retrieve" line of your l^aurel profile, and uses that machine's mail server to read 
and empty them. Messages sent via the Deliver command are forwarded to the mail server 
specified in the "Send" line of your Laurel profile. Arpanet addresses, specified as "name @ site" or "name 
at site", will work correctly only in messages delivered to Maxc. All thisis Strictly temporary — eventually. 
Laurel will understand about mailboxes in multiple places and will introduce its own notions about 
naming message recipients. 
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ALTO SUBSYSTEMS CATALOG 

June 1979 

Filed on [Maxc]<AltoDocs>SubsystemsCatalog.Press. 

This catalog lists and briefly describes die various Alto subsystems. A subsystem is defined to be 
any program Uiat runs on tlie Alto whether under control of die standard executive or as a stand- 
alone. Each subsystem has an entry in this form: 

PrograniName: Description 

DOCUMENTATION: FilePadl 

Italicized ProgmmNames indicate entries that are new or significanUy altered To simplify locating 
a piece of software to perform a specific ftinction, a functional cross reference of Alto subsystems is 
provided beginning on page 8. New subsystems are continually being developed throughout the 
Whole Alto World. This catalog is maintained and distributed by die Whole Alto World 
Coordinator (Ron Cude). If you have or know of a subsystem which you feel should be included, 
please provide the above information to die Coordinator. The following criteria should be met 
before a subsysterii is cataloged and distributed: 

1. The program should be in general use at the installation. 

2. Support should be provided to at least fix major bugs. 

3. Sadsfactory documentation must be available and up to date. 

4. Management must indicate the sensitivity of the item to outside disclosure. 

The subsystems listed arc generally available from your local File Server or Maxc under the <Alto> 
directory; the supporting documentation is found in the <AltoDocs> directory unless otherwise 
noted. If you do not have access to a File Server or Maxc, contact die Coordinator. 

AIS: A driver subsystem which interacts with the user to perform a set of standard operations on 
imaginal data stored as AIS (Array of Intensity Samples) flies. 
documentation: AIS-Manual.press. 

AlSdump: A part of the AIS system to write out to the Diablo disk the decimal values for pixels 
within a specified window. 
DOCUMiiNTATiON: None. 

AlSmagnify: A part of the AIS system to magnify or minify AIS format images in either 1 or 8 

bit/pixel form. 

ix)CUMI:NTAtion: [Erie]<AIS>Memos>AISmagnify.press, 

AISsliow: A part of die AIS system that displays an AIS image file on the Alto display. 
documiiNTATION: [Erie]<AIS>Memos>AISshow.press. 

ANALYZE: A part of the Design Automation System that transforms logic diagrams produced 
using SIL into a file which can be input to the GOBBLE wirelistcr. 
DOCUMliNlAllON: [Maxc]<SlL>SilManual.press. 

APROM: Superseded by PROM. 

ASM: An assembler for the Alto machine language which produces relocatable files compatible 
with die BCPL loader, BLDR. 
documentation: ASM.tty or Subsystems.press. 
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BCA: A basic cioss-asscmbler for micro-computers. 
documentation: BCA.press. 

BCPl/ A compiler for Alto BCPL language which produces files relocatable with the BLDR 

loader. 

DOCUMiiNTATiON : BCPL..tty/.prcss. 

BLDR: A loader for the relocatable files produced by BCPL and ASM. 
documI'-NTATION: BCPL.tty/.press. 

BRAVO: A text editor having extensive formating and hardcopy facilities. 
DOCUMnNTATlON: ALIO User's Handbook, BRAVO Course Oudine, BRAVO.press and 
BRAVOSUMMARY.press. 

BTRJCKTEST: A B-Tree dictionary maintenance program used to support the PROOFREADER 

data base. 

ixjcumI'NIATIOn: ProofReadcr.tty. 

BUILD: a part of the Design Automation System that helps with the data management aspects of 
building boards and keeping the design automation data files current. 
documi-niation: [Maxc]<SlL>SilManual.press. 

BUILDBOOT: a program for constnicting type B bootfiles from either an executable (BLDR out) 

file or a segment file. 

DOCUMENTATION: BUILDBOOT.tty or Subsystcms.press. 

CALCULATOR: a bootfilc that pictures a TI SR-52 on the display which is operated by using the 
mouse to select the appropriate keys. It is not programmable. 
documentation: SR-52 Manual. 

CAFjLFTP: a subset of FTP which always lives in tlie operating system. CALLFTP is much 
stnallcr tlian FTP and can be used when space is tight. 
documentation: FTP manual. 

CHAT: a program for establishing PUP Telnet connections between a pair of cooperating parties. 
Its chief function is to permit Alto users to talk to Maxc. 
iX)CUMENrATiON: ALi'O User's Handbook, CHAT.tty or Subsystcms.press. 

CliFANDIR: a program to garbage collect a disk file directory (but not disk space). 
iXJCUMEN'rA'ilON: Subsystcms.press. 

CONDENSE: a program to retrieve the screen bitmap from the SWAT and SWATEE files for 
display or output to an AIS or Press format disk file. 
DOCUMENTATION: Menu is self-explanatory. 

COPYDISK: a program for copying entire diskpacks. It will copy from one drive to another on 
the same machine, or between drives on separate machines via a network using Diablo IVIodel 31/44 
and Trident T-8O/T-300 disks. 
ixJCUMEN'rATiON: COPYDlSK.tty or Subsystcms.press. 

COPYFROlMDRIVEl: a program to copy an individual file from DPI to DPO of a dual disk Alto. 
IXJCUMENTATION: Subsystcms.prcss. 

CREATFILP^: a prograiu to create a file of a given size, attempting to allocate it on consecutive 

disk pages. 

DOCUMl'NTATlON : Subsystcms.press. 
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CRTTEST: a diagnostic program used to adjust the Alto display linearity. Three different sized 
grids are displayed in rotation (press any key to change grids). 
lxjcumenta'I'IOn: none. 

CRUMPLE: a program to compress and, optionally, encrypt data files. The resulting files can be 
stored or transmitted but must be expanded and decrypted before processing by Alto programs. 
documentation: Crumple.press. 

DDS: a progratr, to manage an Alto diskpack. Facilities are provided to display filenames, lengths, 
crcation-read-write dates, and contents, internal operations such as delete, and rename, and external 
operations such as Send and Execute. 
ix)cumentation: ALTO User's Handbook or DDS.tty or Subsystems.press. 

DMT.BOOT: a memory diagnostic and statistics gathering program. 
DOCUMiiNTATiON: DMT.tty or Subsystems.press. 

DO: a wonderful program giving a parameterized interface to the executive. More powerful than 
CM files, and useful with the IF program. 
ix)Cumentation: DO.prcss. 

DPRINT: a program to type text files on the Diablo HyType printer. 
rxDCUMRNTATlON: DPRINT.tty or Subsystems.press. 

DRAW: an interactive illustrator program for creating black-and-white or color pictures composed 
of lines, curves, and text captions. Tlie illustrations can be output to a one page press file. 
lX)eUMi;NTAT]ON: AL TO User's Handbook plus DRAWnews.press, an on-line manual (part of the 
DRAW package), and 13RAW-Summary.press. 

EDP: an Ethernet interface diagnostic. 
DOCUMENTATION: None. 

EFTP: a small but inefficient Ethernet FTP protocol. 
DOCUMENTATION: EFTPPackagc.tty. 

EMPRESS: a program to send press and text. e.g. bravo format, files to a press printing server. 
Simple formatting options such as Tab and FormFeed are available. 
DOCUMENTATION: EmPrcss.tty or Subsystems.press. 

ERP: a program that listens for event packets on the Ether. Useful for monitoring and gathering 

statistics. 

ix)GUmeni'ation: ERP.press. 

EXECUTIVE: the Alto command processing subsystem, the intermediary by which users generally 
invoke otlier subsystems and perform several operations on the Alto file system. Normally invoked 
by the boot operation. 
documentation: Exccutive.tty or Subsystems.press. 

FIND: a subsystem to search one or more text files for a user supplied string at very high speed 
and then display each line containing an occurence of the pattern on request. 
ix)CUMRNTATIOn: FIND.tty or Subsystems.press. 

FRED: a part of the Font Creation System, it is used to create and/or edit "splines" (i.e. outlines) 

of characters. 

DOCU M en'TATION : [Maxc]<G R-DOCS>Fred.ears. 
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FIT: a file transfer program to store and retrieve files between an Alto and another Alto, Maxc, or 
File Server. It also supports a Telnet connection that is similar to CHAT in purpose and operation. 
documeni'ation: FlT.tty or Subsystems.press. 

GOBBTiE: a part of the Design Automation System that generates a wirelist and routing 
information for a single board given one or more node list files generated by ANALYZE. 
DOCUMF.NTATION: [Maxc]<SIL>SilManual.press. 

GYPSY: a modeless text editor using both keyset r^nd mouse, and having a "filing cabinet" 
interface which provides some file management facilities beyond the normal Alto filing system. 
Used in applications where limited formatting facilities are required such as programming. 
documI'NTATIOn: Under development. 

IIARDCOPY: a wonderful program that retrieves and prints files from anywhere, your Alto, Maxc, 
a File Server, etc. 
documentation: HardCopy.tty. 

ICA]iUS2: a part of the ICARUS2 System, it is an interactive program for actually laying out 
printed circuits and manipulating the resulting files. 
documentation: [Maxc]<ICARUS>Icarus2doc.press, ICtools.press. 

IF: a program allowing conditional execution of executive commands. Usefijl in conjunction with 
DO files and CM files. 
documentation: IF.press. 

1FD2: a part of the ICARUS2 System that turns an ICARUS2 file into human readable form, 
describing each symbol and its contents. 
documentation: [Maxc]<ICARUS>IFD2doc.press. 

IFS: tlic Ivy File System server that provides one end of the file transfer facility and maintains the 
files and directories on Trident T-8O/T-300 disks. 
documentation: [Maxc]<IFS>IFSdocuments.press. 

IFSSCAVENGER: a subsystem to check and correct Trident T-80/T-300 diskpacks from the Ivy 
and Trident File Systems. 
documentation: [Maxc]<IFS>ScavOp.press. 

INSTALLSWAT: an installation program to install the SWAT debugging system on your disk. 
DOCUMEmATlON: None. 

KAL: a kalidescopc program that you Etherboot. 
ixjcumentation: None. 

KEYTEST: a diagnostic program that displays the Alto keyboard, keyset and mouse. The 
depressing of any key(s) is reflected by inverting (white to black) the display of that key on the 
screen. If the keyboard displayed doesn't match the one you are using, move the cursor to the 
bottom of the display and hit any mouse button. 
DOCUMi'NTATiON: nonc. 

LAUREL: a Maxc MSG compatible, display-based, message system diat runs on your Alto. 
DOCUMENTATION: [Maxc]<Laurel>Laurel.press and a system tutorial retrieved with Laurel software. 

LISTSYMS: a programming aid to convert a .Syms file (produced by BLDR) to a usefiil, human 

readable form. 

DOCUMENTATION: ListSyms.tty or Subsystems.press. 
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LOGrCPROM: Superseded by PROM. 

IVIAiyri'lS'r: a bootfilc diagnosdc diat runs tests on an Alto's RAM, ALU, and emulator. 
iX)CUMf:NrA'i'iON: Alto User's Primer. 

MAILCHKCK: a simple subsystem that checks for mail at some other host (e.g. Maxc) via the 

l^thcrnct. 

documi-ntajion: MailChcck.tty or Subsystems.press. 

MARKUI*: an illustrator used to add pictures consisting of lines, areas, mouse tracks and text 
captions to formatted documents, i.e. Press files. It may also be used to simply display press files. 
DOCUMl'.N'lAriON: Alto User's Handbook. 

Ml'',NUl<;i)rr: a program that edits menus for the BCPL menu package. 
DOCUMPNrAllON: Menu.prcss. 

IVirKK: a part of the ICAIIUS2 System that transforms ICARUS2 files into a form suitable for the 

Mann 3000 pattern generator. 

i:)OCUM |-N lAiiON : [Maxcl< 1CARUS>M ikeUserDoc.press, MikeDocprcss. 

MOVK'i'OKEYS: Obsolete. non-ftincUonal. 

MU: the Alto Microcode assembler. 
documentation: MU.tty or Subsystems.press. 

NKPTUNI*',: a small, fast DDS-like program for manipulating your Alto directory. 
documuntation; Ncptune.prcss. 

NICrwORK l''XEClJ'riVK: the executive obtained by booting from the Gateway over the Ethernet 
that provides a convenient way to call "bootfiles" such as FIP or COPYDISK. 
oocuMr.NiATlON: NctRxec.tty. 

NPGR: Obsolete part of the Sil system. 

NPPR: Obsolete part of the Sil system. 

OKDIT: a subsystem for displaying and modifying Alto files in octal. Up to four files may be 
simultaneously viewed while one of them may be modified. 
ixjcumI'NIAtion: Oedit.tty or Subsystems.press. 

ORBri"H:ST: the Ol^niT interface diagnostic. 
ix)CUMi;niaiion: [[vy]<Sprucc>ORBrrtest.prcss. 

PACKMU: a program to convert the output of MU (an MB file) to a "packed RAM image" which 
is easy to load into the RAM using RPRAM. 
lX)CUlvii:NTAriON: PackMU.tty or Subsystems.press. 

PKEK: a program which listens to the Rthernct for PcekReports and liventReports. It can also 
serve as a bootserver and Ethernet Echo server for use with EDP. 
DOCUMI'NlAnON: DMT.tty. 

PEK.KPLIP: a small subsystem enabling one to peek at Pups going to and from a particular 
Ethernet host; a debugging aid for new Pup software. 
documI'NIAtion: PcekPup.tty or Subsystems.press. 



Alto Subsystems Catalog - June 1 979 



PEEKSUM: a subsystem that summarizes tlic error reports sent to PFiEK by DMT. 
DOCUMr'NTATION: DMT.tty. 

PRICPRFJSS: a part of the Font Creation System that takes "spline character definitions", usually 

created by FRED, and geiieratcs scan-converted characters, spline and character dictionaries, 

readable listings describing the dictionary's content, and a "widths" file for use by text formating 

programs. 

documentation: [Maxc]<GR-DOCS>PrePrcss.prcss. 

PRESS: a subsystem to print full press files on press printers. 
nocuMi'Ni ATiON : [Maxc]<GR-DOCS>PressOps.press. 

1*RI'!SSE!)T1': a program to combine Press files together, convert F-ars files (generated by Pub and 
liravo) to Piess format, selecting certain pages from a Press or fiars file, or to add extra fonts. The 
output is a Press file. 
DOCUMi'NTAiroN: PressEdit.tty or Subsystems.press. 

PROM: a subsystem to edit microcode, drive the Alto PROM blower and verify PROMs. 
documhniation: PROM.bravo. 

PUOMDIAG: Superseded by PROM. 

PROOEREADER: an interim English text proofreader that produces an output file listing tlic 
qucstionably-spcllcd words. 
pocuMiiNlATiON: Proofllcader.tty. 

PUPTEST: a PUP protocol and network integrity test program. 
DOCUMF.NrATiON: None. 

PU'I': a program for transferring files between the disks of a dual-drive Alto. Its function is also 
performed by the more comprehensive NEFfUNE. 
oocuMi'NrAriON: Internal to the program. 

QEI): an in-corc line editor used primarily for programming. The file is limited to about 1500 

lines of liCPL. 

DOCUMi'N'i ATION: QED.tty or Subsystems.press. 

RAMEOAI): a inicrocode loader that uses the output of the microcode assembler, MU, 
documI'NI'ation: RamI.oad.tty or Subsystems.press. 

RAM'I'IMING: a bootfilc diagnostic program to test the Alto RAM. Its function is also performed 
by the more comprehensive MADTEST. 
DOCUMI'NI'ATION: None. 

Rl'.ADPRESS: reads Press files and displays a text-listing of the entity commands, DL strings, etc, 

documI'NTAiion: Subsystems.press. 

RENAME: Obsolete replacement for tlic Executive's Rename command. 

RPRAM: a microcode loader that loads a packed RAM image (generated by PACKMU) into the 
RAM after checking tlie constant memory. 
documentaiion: PackMU.tty or Subsystems.tty. 

SCAVENGER: a subsystem for checking and correcting Alto disk packs. 
iK)CUMF.NrAriON: Scavenger.tty or Subsystems.press. 
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SFXriMK: Obsolete. 

ShowAIS: a bootfile that halftones and displays 8 bit/pixel AIS files stored on a remote file server. 

(Use of this program significantly loads the file server, limiting overall performance. Do not use it 

frivolously.) 

rwcuMi'NTATlON: ITvy]<Malcson>ShowAlS.bravo. 

SIGMA: a subsystem to transfer arbitrary files between an Alto and a SIGMA 3 over the Ethernet. 
DOCUMi'.NTATiON: "Ethernet Software for Data Transfer between the SIGMA 3 and an ALTO", a 
Xerox Internal Report, Accession No. X7704459. 

SIL: a part of the Design Automation System, it is an illustrator for the creation of logic and line 
diagrams. The output can generate Press files or be processed by ANALYZE for circuit design, 
iX)CUIV11-ntation: [Maxc]<SIL>SilManual.press. 

SORT: a very small subsystem which will sort files containing less than iOOO entries delimited by a 

carriage return. 

iX)CUMi'NrATiON: Subsystems.press. 

SPRUCE: a printer server that utilizes the ORBIT buffer to drive Press printers, e.g. Dover and 

Sequoia. 

documf.ntation: [Maxc]<Spruce>SpRiceManual.press. 

SWAT: a emulator-level code debugger with BCPL oriented features used with the Alto operating 

system. 

documI'NTAtion: Swattty or Subsystems.press. 

SYS.BOOT: the operating system boot file on the Alto disk. 
rwcuMHNTATiON: None. 

TFUi a file utility used to initialize a Trident pack with a virgin file system and to perform various 
file copying, deleting, directory listing operations. This is not a part of the Ivy System, rather it 
initializes and maintains packs operated on by the TFS package. 
documI'NFATIOn: TFS.tty or Subsystems.press. 

TRANSFILE: a part of the ICARUS2 System that translates the intermediate files generated by 
Mike into human-readable form. The files it produces are fully instantiated. 
documentation: [Maxc]<ICARUS>rransfileDoc.press. 

TRIEX: a Trident diagnostic used to debug and exercise Trident disk drives. 
documen'iation: Self-contained. 

TYPE: a functional replacement to tlie Executive supplied "type.~" that displays a larger page, 
suppresses Bravo trailer information, can skip forward and backward, etc. 
documentation: lTPK.tty. 

UGH: an in-core text editor utilizing both mouse and keyset. While some formating facilities are 
available, it is used primarily for programming. 
DOCUMUNIATION: UGM.tty. 

VIEWDATA: a subsystem to display on the Alto screen three-dimensional data stored as a two- 
dimensional array of single-word values. 
documI'NTAtion: ViewData.tty. 
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VIKWIC: a part of the ICARUS2 System that displays the data created by Mike on the Alto 
screen, simulating the actions of the pattern generator. 
documI'NTAtion: [Maxc]<ICARUS>ViewicDoc.press. 

VPRINT: a subsystem to output text files such as .TTY, UGH, BRAVO, or GYPSY, to a Versatec 

printer. 

documontation: Under development. 
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FUNCTIONAL CROSS REFERENCE 

I'hc following list of Alto subsystems is organized according to the general function they perform. 
Ikcausc many subsystems perform more than one function or a function may be thought of in a 
variety of ways, an item may be listed more than once. 



The major functional headings are: 



Document Creation 

1^'iles 

Font Creation 



DOCUMENT CREATION 



Hardware Design 
Hardware Diagnostics 
Hardware Drivers 
Recovering 



Messages 

Printing 

Programming 



EDIIOUS 
I KXT 



BRAVO: Rich in formatting features. 

GYPSY: Features to handle groups of files (e.g. chapters or modules). 

PROOl'RF^ADKR: Produces an output file of questionably spelled words. 

QED: A line editor. 

UGH: An in-corc editor that uses the keyset for command input. 

GRAPHIC 

DRAW: Pictures composed of lines, curves, text and smoothed mouse tracks. 

FRliD: A Spline editor for font work. 

MARKUP: Dot pictures of lines, areas, text, and mouse tracks. 

SII.: J'or creating diagrams composed of lines with text captions. 

IIVIAGPS 

AIS: Image manipulation, printing, Press file creation. 
I'AGE MAKEUP 

MARKUP: Create new or move pre-existing diagrams along side existing text. 

MERGING 

AIS: Merges bitmap files (e.g PRESS output and AIS files). 
HM PRESS: Append press files to personalized covcrsheets. 
PRESSF-DIT: Generate Press files from pages of odicr Press files. 

PRINTING: see PRINTING below. 



FILES 



niSPIvAY 



AlSshow: AIS files. 
Ol'DIT: Alto files in octal. 
MARKUP: Press files. 
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PRESS: Press files. 

READPRHSS: Press file internals. 

ShowAlS: 8 bit/pixel AIS files from remote file servers. 

TYPE: 'Icxt files. 

VIEWDA'l'A: Three-dimensional infoitnation stored as a matrix of values. 

TRANSFER 

COPYDISK: Copies whole disks, Di?Mo Models 31/44 and Trident T-80/'I'-300. 

FTP: Copies a file between Altos, Alto-File Server, and Alto-Maxc. 

GYPSY: Transmits its files to a Communicating 800 ETS. 

NEPTUNE: Copies files between disks of a dual drive Alto. 

F'UT: Copies files between disks of a dual drive Alto. 

SIGMA: Copies files between Alto and SIGMA 3. 

TI'U: Copies files between Trident drives. 

ALTO KILE SYS'TEJVr 

CALLFTP: Very small version of FTP. 

CLEAN DIR: Garbage collect disk directory. 

CREATEPILE: Adds new file of specified size on consecutive pages, il possible. 

CRUMPLE: Compresses and optionally encrypts a file. 

DDS: Large directory manipulation subsystem. 

EXECUTIVE: Delete files, list directory. 

FIND: Locates and displays lines containing a specified text string. 

FTP: Transfers files between Alto and Alto, a File Server, or Maxc. 

NEPTUNE,: Small directory manipulation subsystem. Deletes, renames, and 

copies files between disks of a dual drive Alto. 

OEDTT: Display and modify file in octal. 

PUT: Deletes, renames, and copies files between disks of a dual drive Alto. 

SCAVENGER: Checks and corrects the disk. 

SIGMA: 'Transfers files between an Alto and SIGMA 3. 

SORT: Sorts up (o 1000 items delimited by carriage returns. 

TYPE: Displays contents of text files. 

FILE SERVER SYSTEM 

IFS: The server. 

IFSSCAVENGER: Checks and corrects Trident T-80/T-300 disks. 

TFU: Initialize directory and verify disk. 

TRIDENT FILE SYSTEM 

IFSSCAVENGER: Checks and corrects Trident T-80/'T-300 disks. 
'['FU: Initialize and list directory, verify disk, copy and delete files. 

RICCOVERY 

IFSSCAVENGER: Check and correct disks of File Server and Trident file 

systems. 

SCAVENGER: Check and correct disk of Alto file system. 

FONT CREATION 

SPLINES 

DRAW: Create splines using mouse or knots. 
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FRED: Create and edit splines, create font files. 
BITMAPS 

PREPRESS: Scales and rotates splines, converts to and edits bitmaps. 
DEVICE FORMATS 

PREPRESS: Creates printer and display fonts from bitmaps. 

HARDWARE DESIGN 

CIRCUIT BOARD 

SIL: Create and edit logic diagrams. 

ANALYZE: Converts SIL drawing for GOBBLE, generates SIL- of unassigncd 

pins. 

GOBBLE: Generates wirelist and routing infonnation, 

BUILD: Aids data management aspects, keeping data files current. 

INfEGRATED CIRCUIT 

1CARUS2: Layout integrated circuits. 

IFD2: Generates human readable form of ICARUS2 files. 

MIKE: Transforms ICARUS2 file to form for Mann 3000 pattern generator. 

IR ANSFILE: Generates human readable form of MIKE file. 

VIEWIC: Displays MIKE output. 

ICGERB: Generates Gerber photoplotter output from ICARUS files. 

HARDWARE DIAGNOSTICS 



USER 



CRTTEST: Displays a rectangular grid, (.boot/.run files). 

DMT: Memory diagnostic tliat transmits results to PEEK. (Alto/server boot files). 

EDP: Ethernet interface diagnostic, 

KEYTHST: Keyboard diagnostic, (.boot/.run files). 

MADTEST: Diagnostic for RAM, ALU, and emulator, (.boot/.run files). 

TRIEX: A Trident r-80/T-300 diagnostic. 

INSTALLATION 

DISKTEST: Bootfile diagnostic for the Diablo Model 3L 
ORBI'llEST: An ORBIT Interface diagnostic. 
PEEK — Collects PcckReport/EvcntReport packets on <filename>. 
PEI':KSUM— Summarizes DMT error reports collected by PEEK. 
PUITES'I' — Ascertains status of network servers. 

HARDWARE DRIVERS —Sqq the Alto Hardware Catalog under appropriate device. 
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MESS AGES 

SKINDING 

CHAT— Accesses SNDMSG on Maxc. 

LAUREI.— Display-based, MSG compatible, running on Alto. 



HICCEIVING 



MAILCEII^CK — Interrogates Maxc for new mail. 

CHAT — Accesses MSG on Maxc to retrieve mail. 

LA URHL— Display-based, MSG compatible, running on Alto. 



PRINTING 



RKIVIOIK 

RIOrORMATING 

PRHPRP,SS— Generates a Press Pie from .tty and many .press files. 

PR less 

BRAVO— Sends the workfilc to Spruce. 

RM PRESS— Sends the specified Press and/or Text files to Spruce. 

HA RDCOI>Y— Prints any file any place. 

GYPSY— Sends the workfile to Spnice. 

SPRUCE- A Press server for Dovcr/Sequoia/Pimlico. 

LOCAL 

BRAVO— Prints the workfile on the attached Diablo HyType. 
DPRINT— Prints text files on the attached Diablo HyType. 
GYPSY— Prints the workfile on the attached Diablo Hytype. 
PRESS — Prints Press files on slot and Versatec printers. 
VPRIN'r — Prints text files on Versatec printers. 

P ROGRAM MING 

EDITORS-See DOCUMENT-EDirORS-TEXT above. 

ASM/BCPL 

ASM — Alto machine language assembler. 

BCPL— BCPL compiler. 

BLDl^— Loader for ASM and BCPL relocatable files. 

BU I I.DBOOT— Generates a type B bootfilc. 

SWAT — an emulator level, BCPL oriented debugger. 

INSTALLSWA'l— Installs SWAT on a disk. 

LIS IS Y MS— Converts .SYMS files to human readable form. 
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MU 



MU — Microcode assembler. 
RAMLOAD-Loads RAM wiUi MU output. 
PACKMU— Converts MU output for RPRAM. 
RPRAM— Loads RAM with RPRAM output 



DEBUGGING AIDS 



AlSdump — Writes out pixel values in decimal. 

CONDENSE— Recovers display bitmap from SWAT or SWATEE file. 

SWAT— An emulator level, BCPL oriented debugger. 

LlS^rSYMS— Converts .SYMS files to human readable form. 

B'i'RRHTESr— A B-tree dictionary maintenance program. 

PEEK PUP— Peeks at PUPs going to and from a specific Etliernet address. 

PUFrEST — Interacts with new subsystems that use the PUP protocol. 

READPRESS— Displays entities within a Press file. 



RECOVERING 



DISK FAILURES— See FILES-RECOVERY above. 

SUBSYSTEMS FAILURES 

BRA VOBUG— Recovers BRAVO files to point of failure. 
CONDENSE— Recovers display bitmap from SWAT or SWATEE file. 



